Add intent proof
POST/intents/{id}/proofs●Submit a signed proof to an intent record.
Appends a signed proof to the intent record. The proof must be signed against the record's current hash — see About Proofs for how signing and validation work.
Proofs drive the intent through its DTC lifecycle. Each proof carries a status that may trigger a state transition:
pending → prepared → committed → completed
If a bridge reports a failure, the intent transitions through
failed → aborted → rejected.
Status policies can introduce additional statuses into the lifecycle.
Returns the updated record with the new proof in meta.proofs.
Broadcasts the intent-proofs-added signal. Use
effects to subscribe.
Usage Examples
curl -X POST "http://localhost:3000/v2/intents/<HANDLE>/proofs" \ -H "x-ledger: <YOUR LEDGER HANDLE>" \ -H "Content-Type: application/json" \ -d '{ "method": "ed25519-v2", "public": "RyXTVL6wSgoBMSZRmTnnKBc82dQGLn5y4Nlp8KRwMLA=", "digest": "524b839221228652aceae20c42717411e08b0d325370d9ebbba983aa2f86b081", "result": "4ACQsuhAdW7Y8l3nFBq8NJ2yVnvjGrRleCR5vC9bu0rD6+0VqpxDzgOKwvQ54T926WmlRT+6iIZhuTpiPGIjDQ==", "custom": { "moment": "2025-04-05T14:30:10.000Z", "status": "prepared", "handle": "bridge-entry-handle", "coreId": "external-txn-id-456" } }'{
"luid": "$int.-01xK0rStT2dS4wX3",
"hash": "be40db4425c914903888398a39519b6e9c9b0e047afd40c64f78c95f8f6d64f1",
"data": {
"handle": "transfer-1712345678901",
"claims": [
{
"action": "transfer",
"source": {
"handle": "svgs:1001001212@tesla-bank.com",
"custom": {
"name": "John Doe",
"idType": "nidn",
"idNumber": "123456789",
"entityType": "individual"
}
},
"target": {
"handle": "tran:1001001234@nova-bank.com",
"custom": {
"name": "Jane Smith",
"idType": "nidn",
"idNumber": "987654321",
"entityType": "individual"
}
},
"amount": 500,
"symbol": {
"handle": "usd"
}
}
]
},
"meta": {
"status": "pending",
"moment": "2025-04-05T14:30:10.020Z",
"owners": [
"RyXTVL6wSgoBMSZRmTnnKBc82dQGLn5y4Nlp8KRwMLA="
],
"proofs": [
{
"signer": "tesla-bank-bridge",
"method": "ed25519-v2",
"digest": "6470993982c70f230a95d9084a2ae7b86e612efa57d9f9de9fc379a32923646f",
"public": "RyXTVL6wSgoBMSZRmTnnKBc82dQGLn5y4Nlp8KRwMLA=",
"result": "VUq9NdRZcIk/g85nQTDqsAloXEs6tceZZWw3yPzMeiohjZiZ+FK1lHgQY4haI2C+ZzDMD/lTcqpihKPOq82VBg==",
"custom": {
"moment": "2025-04-05T14:30:00.000Z",
"status": "created"
}
},
{
"signer": "system",
"method": "ed25519-v2",
"digest": "7b75a12a0a9f29fb903461a2c9d1e4d50e7092199c7bef460e6550e09056d7ac",
"public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
"result": "rAiwYdEpgfJK7Cd3nYLJgrM/YTKphjh6gPAh6+z2Wm6IYubg+2CbyJAjKSp69T+bQikHqGAYypy2eUTG/7u6CQ==",
"custom": {
"luid": "$int.-01xK0rStT2dS4wX3",
"moment": "2025-04-05T14:30:00.050Z",
"status": "created"
}
},
{
"signer": "tesla-bank-bridge",
"method": "ed25519-v2",
"digest": "524b839221228652aceae20c42717411e08b0d325370d9ebbba983aa2f86b081",
"public": "RyXTVL6wSgoBMSZRmTnnKBc82dQGLn5y4Nlp8KRwMLA=",
"result": "4ACQsuhAdW7Y8l3nFBq8NJ2yVnvjGrRleCR5vC9bu0rD6+0VqpxDzgOKwvQ54T926WmlRT+6iIZhuTpiPGIjDQ==",
"custom": {
"moment": "2025-04-05T14:30:10.000Z",
"status": "prepared",
"handle": "bridge-entry-handle",
"coreId": "external-txn-id-456"
}
}
]
}
}{
"hash": "b7eb7ccf5ffc126951e13e29a8dcfdaf95db859715d4edfc2d16f59a79d4cd58",
"data": {
"reason": "auth.unauthorized",
"detail": "Invalid token."
},
"meta": {
"proofs": [
{
"signer": "system",
"method": "ed25519-v2",
"digest": "3acece870c4118bfe4223118e4d2f3cfd5b8947a7093785b66d49aa57fa2890a",
"public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
"result": "gnK63DqqWDY/UXvnZHixDKPKS6tfeGHgdARylnPiJLwQGyYxuD97TYbSg2wrzsf/bDrHwQYZaf8Gu5ryYP0UAA==",
"custom": {
"moment": "2025-04-05T14:30:00.000Z"
}
}
]
}
}{
"hash": "9ec02726b50650add8acfd124c6defeb978a9ac252a5de888f9493ddc701e927",
"data": {
"reason": "auth.forbidden",
"detail": "Request is not authorized"
},
"meta": {
"proofs": [
{
"signer": "system",
"method": "ed25519-v2",
"digest": "4f8cbdc38d73348de0c31805c783c84a0fecc6be736d7e187004ba68cd00e675",
"public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
"result": "P3hRnveehtuobb4AIO56XBmiduvmYJbpdmOHltG/IifBEH7QSWdv/0pqled4SO9x1Ne3oXuWxJy40DzMvx1MBA==",
"custom": {
"moment": "2025-04-05T14:30:00.000Z"
}
}
]
}
}{
"hash": "d6c59a6df7165fa4a75159799ca5f5e26e544cbb8769eced3d35d8021f6f7935",
"data": {
"reason": "record.not-found",
"detail": "Signer not found"
},
"meta": {
"proofs": [
{
"signer": "system",
"method": "ed25519-v2",
"digest": "78cf86f34aefcf9da6ed4167a38aac0a2739f68f7bafb1d3e033c01ed1b6cdf1",
"public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
"result": "9Ledk+/iAAtj+uLjGe2afq4kID7n8UQD6UpRpLBCujxFjxddq0uZ2tnYRTAXmYdHDkbF0uXqtNM9qO3xhEtpAA==",
"custom": {
"moment": "2025-04-05T14:30:00.000Z"
}
}
]
}
}{
"hash": "1c084e8dcfb9bb84bc8ea96e9e137b149a34b2bbd85f8e60b4263f5aba980476",
"data": {
"custom": {
"errors": [
{
"instancePath": "/handle",
"schemaPath": "#/properties/handle/pattern",
"keyword": "pattern",
"params": {
"pattern": "^[a-zA-Z0-9_\\-+.]+$"
},
"message": "must match pattern \"^[a-zA-Z0-9_\\-+.]+$\""
}
]
},
"reason": "record.schema-invalid",
"detail": "Schema validator error: data.handle must match pattern \"^[a-zA-Z0-9_\\-+.]+$\""
},
"meta": {
"proofs": [
{
"signer": "system",
"method": "ed25519-v2",
"digest": "7a5febb431719b6f43d7e88e79211308e16ac651b71b339276373fdb4e7c3760",
"public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
"result": "2/1zYw4AaIzsIHfOIC6V/CHw6owbjYHt48cwmFOig0ibeT0IbojLmj1RCRi8W00ka0udPa9WsacWDd7ObMY8CA==",
"custom": {
"moment": "2025-04-05T14:30:00.000Z"
}
}
]
}
}{
"hash": "93a5f4d97a42c2df97f827c58ff7768d02568c15aca931e22b81fa3160ba0df3",
"data": {
"reason": "api.unexpected-error",
"detail": "An unexpected error occurred"
},
"meta": {
"proofs": [
{
"signer": "system",
"method": "ed25519-v2",
"digest": "efaf5360143b586917d9636779ad6e08571c5b06909a20dd0f5eba4bf3be7eae",
"public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
"result": "hERh6Aecj59iR+Fb25OQsHJScOi4t8EiffKSfjlMQdjHMccTnfDlgZFdaJzXzUtpSwy/NHq0l+7ydh3HSWCoAg==",
"custom": {
"moment": "2025-04-05T14:30:00.000Z"
}
}
]
}
}Path Parameters
id*|
The unique identifier of the record - it is luid or handle (address).
Header Parameters
x-ledger?|
The unique identifier of ledger in context for multi tenant requests.
Request Body
application/json
Proof body
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
Get intent GET
The response includes the current DTC status and all proofs collected so far, which can be used to track processing progress.
Check intent access POST
Evaluates access policies for the calling signer and returns the resolved permissions. The request body specifies the action and optionally the record type to check against.