Checklist de Integração

Objetivo: Ir da ideia para cauções ativas em menos de 1 semana.

Estimativa de tempo: 4–8 horas de implementação (mais testes).

Pré-requisitos:

• Conhecimento básico de Web3

• Uma carteira Stellar (Freighter, Albedo)

• Acesso a stablecoins (USDC/EURC no testnet ou mainnet)

---

Fase 1 – Preparação (Configuração & Planejamento)

1. Entenda seu caso de uso

• Defina seu fluxo de trabalho de custódia: liberação única (pagamento total ao final) ou liberação múltipla (pagamento por marco).

• Mapeie o ciclo de vida da transação: Iniciação → Financiamento → Atualizações de Marco → Aprovação → Liberação (→ Disputa se necessário).

📄 Ciclo de Vida da Caução

2. Escolha o Tipo de Caução Correto

• 📄 Tipos de Caução

• Liberação Única — pagamento total após todos os marcos aprovados.

• Liberação Múltipla — pagamentos escalonados por marco.

3. Defina Papéis

Atribua os endereços Stellar das partes a cada papel na sua caução:📄 Papéis em Trabalho Trustless

• Aprovador — aprova ou contesta marcos.

• Prestador de Serviços — entrega o trabalho, marca marcos como concluídos.

• Assinante de Liberação — libera fundos uma vez que as aprovações estejam completas.

• Resolutor de Disputas — resolve disputas.

• Endereço da Plataforma — recebe taxas da plataforma.

• Recebedor — destinatário final dos fundos.

4. Defina Propriedades da Caução

Propriedades da Caução

• Configuração de ativo & trustline

• Valor & taxa da plataforma

• ID do engajamento (referência de fatura/pedido)

• Marcos (título, descrição, critérios de aceitação)

---

Fase 2 – Integração (Configuração Principal)

5. Obtenha Acesso

• Inscreva-se em dApp.

• Solicitar Chave de API (testnet; mainnet após auditoria) Solicitar Chave de API -> você pode ver os vídeos na página inicial do dApp.

• Você pode implantar cauções no testnet & Mainnet no backoffice. Ótimo para testar e integrar.

6. Instale o SDK / Ferramentas Introdução - SDK

• Instale o pacote NPM.

• Importe o SDK para seu projeto.

• Clone ou referencie templates de código aberto para seu vertical (por exemplo, P2P, marketplace, plataforma de subvenções).

• OU: Use blocos de caução

7. Configure Sua Caução

• Defina papéis, endereços, valor, taxas e marcos.

• Escolha a lógica de liberação única ou múltipla.

• Use ativo do testnet para integração inicial.

---

Fase 3 – Testes (Validação & Depuração)

8. Faça o Deploy no Testnet

• Crie sua primeira caução via API ou SDK.

• Financie-a usando uma carteira do testnet (por ex., Freighter, Albedo).

• Percorra o fluxo de conclusão de marco e aprovação.

9. Simule Casos de Borda

• Tratamento de disputas

• Financiamento parcial

• Fluxos de timeout ou cancelamento

10. Execute Revisão de Conformidade & UX

• Prontidão KYC/AML (se necessário para seu vertical).

• Teste a conexão da carteira & a experiência de assinatura.

---

Fase 4 – Lançamento (Entrar em Produção)

11. Migre para o Mainnet

• Mover Trabalho Trustless para o Mainnet

• Implemente contratos no Mainnet usando SDK ou API.

• Financie as primeiras cauções ao vivo com stablecoins.

12. Monitorar & Otimizar

• Use o visualizador ou o backoffice do dApp para acompanhar status da caução, financiamento e liberação.

---

---