Skip to main content

Escrow Overview

Ikawaari includes an implemented escrow domain with dedicated APIs for contracts, releases, and disputes.

Implemented escrow route families​

Current escrow APIs include:

  • api/v1/escrow/contracts
  • api/v1/escrow/releases
  • api/v1/escrow/disputes

Core escrow objects​

Contracts​

Escrow contracts define the protected commercial agreement and its lifecycle.

Releases​

Releases represent the movement from protected escrow state toward approved and executed release of funds.

Disputes​

Disputes capture contested situations that block or alter the normal release flow.

Documentation priorities​

The escrow section should expand into:

  • contract creation and listing
  • submit-for-funding workflow
  • release creation, approval, execution, and cancellation
  • dispute creation, resolution, and closure
  • lifecycle diagrams and state-machine documentation
  • escrow error catalog and troubleshooting

Typical lifecycle​

stateDiagram-v2
  [*] --> Draft
  Draft --> SubmittedForFunding
  SubmittedForFunding --> Funded
  Funded --> ReleaseCreated
  ReleaseCreated --> Approved
  Approved --> Executed
  Funded --> Disputed
  Disputed --> Resolved
  Resolved --> ReleaseCreated
  Executed --> Closed