Permissions required: Propose and Accept settlements
Propose a settlement with a counterparty for a list of assets coming from and/or arriving into wallets owned by your participant.
Positive amounts indicate funds to be received and negative amounts indicate funds to be sent.
[
{
"walletId": "d4578f401daadff65615236c5ad1e12c",
"quantity": "-1.1",
"assetType": "BTC"
},
{
"walletId": "43a9aeac02c851f4868f9d89aabde494",
"quantity": "20.62",
"assetType": "ETH"
}
]For example, the above wallet amounts indicate you will send 1.1 BTC from your wallet d4578f401daadff65615236c5ad1e12c and receive 20.62 ETH into your wallet 43a9aeac02c851f4868f9d89aabde494.
The steps to create a settlement are:
- The proposer participant proposes it, selecting an acceptor, assets, amounts and wallets.
- The proposer authorizes it, either through the API or mobile app signing.
- The acceptor participant accepts it, selecting wallets to use.
- (optional) The acceptor authorizes it, either through the API or mobile app signing.
- The settlement is funded in the sending wallets.
- The assets are transferred on-chain, as directed by the settlement.
Steps 2 or 3 can happen out of order.
Step 4 is skipped if the acceptor is not sending any assets.
The settlement stays in the ActionNeeded state until it reaches step 6. Then it enters the Executing state and, after that, it enters one of the final states.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||