Entidades

Escrow

Contém tanto tipos de liberação única quanto de múltiplas liberações.

/**
 * Escrow de Liberação Única
 */
export type SingleReleaseEscrow = {
  /**
   * Endereço do usuário que assina a transação do contrato
   */
  signer: string;

  /**
   * ID (endereço) que identifica o contrato escrow
   */
  contractId: string;

  /**
   * Identificador único para o escrow
   */
  engagementId: string;

  /**
   * Nome do escrow
   */
  title: string;

  /**
   * Papéis que compõem a estrutura do escrow
   */
  roles: Roles;

  /**
   * Texto descrevendo a função do escrow
   */
  description: string;

  /**
   * Quantia a ser transferida ao completar os marcos do escrow
   */
  amount: number;

  /**
   * Comissão que a plataforma receberá quando o escrow for concluído
   */
  platformFee: number;

  /**
   * Quantidade do token (XLM, USDC, EURC, etc) no contrato inteligente.
   */
  balance: number;

  /**
   * Objetivos a serem concluídos para definir o escrow como concluído
   */
  milestones: SingleReleaseMilestone[];

  /**
   * Flags validando certos estados de vida do escrow
   */
  flags?: Flags;

  /**
   * Informações sobre a trustline que gerenciará o movimento de fundos no escrow
   */
  trustline: Trustline;
};

/**
 * Escrow de Múltiplas Liberações
 */
export type MultiReleaseEscrow = Omit<
  SingleReleaseEscrow,
  "milestones" | "flags" | "amount" | "roles"
> & {
  milestones: MultiReleaseMilestone[];
  roles: Omit<Roles, "receiver">;
};

Marco (Milestone)

Contém tanto tipos de liberação única quanto de múltiplas liberações. Ambos baseados no BaseMilestone.

/**
 * Marco (Milestone)
 */
type BaseMilestone = {
  /**
   * Texto descrevendo a função do marco.
   */
  description: string;

  /**
   * Status do marco. Ex: Aprovado, Em disputa, etc...
   */
  status?: string;

  /**
   * Evidência do trabalho realizado pelo prestador de serviço.
   */
  evidence?: string;
};

/**
 * Marco de Liberação Única
 */
export type SingleReleaseMilestone = BaseMilestone & {
  /**
   * Flag de aprovado, apenas se o escrow for de liberação única
   */
  approved?: boolean;
};

/**
 * Marco de Múltiplas Liberações
 */
export type MultiReleaseMilestone = BaseMilestone & {
  /**
   * Quantia a ser transferida ao completar este marco
   */
  amount: number;
  
  /**
   * Endereço para onde os recursos do marco serão enviados
   */
  receiver: string;

  /**
   * Flags validando certos estados de vida do marco, apenas se o escrow for de múltiplas liberações
   */
  flags?: Flags;
};

Trustline

/**
 * Trustline
 */
export interface Trustline {
  /**
   * Endereço público que estabelece permissão para aceitar e usar um token específico.
   */
  address: string;
}

Flags

Todas as flags possíveis apenas em escrow de múltiplas liberações.

/**
 * Flags
 */
export type Flags = {
  /**
   * Flag indicando que um escrow está em disputa.
   */
  disputed?: boolean;

  /**
   * Flag indicando que os fundos do escrow já foram liberados.
   */
  released?: boolean;

  /**
   * Flag indicando que um escrow em disputa já foi resolvido.
   */
  resolved?: boolean;

  /**
   * Flag indicando se um marco foi aprovado pelo aprovador.
   */
  approved?: boolean;
};

Roles

/**
 * Papéis
 */
export type Roles = {
  /**
   * Endereço da entidade que requer o serviço.
   */
  approver: string;

  /**
   * Endereço da entidade que fornece o serviço.
   */
  serviceProvider: string;

  /**
   * Endereço da entidade que possui o escrow
   */
  platformAddress: string;

  /**
   * Endereço do usuário responsável por liberar os fundos do escrow para o prestador de serviço.
   */
  releaseSigner: string;

  /**
   * Endereço responsável por resolver disputas dentro do escrow.
   */
  disputeResolver: string;

  /**
   * Endereço para onde os recursos do escrow serão enviados (Na versão “Multi-Release", 
     este papel fica no nível do marco.)
   */
  receiver: string;
};

/**
 * Papel
 */
export type Role =
  | "approver"
  | "serviceProvider"
  | "platformAddress"
  | "releaseSigner"
  | "disputeResolver"
  | "receiver"
  | "signer";