Error

A valid request URL is required to generate request examples

{
  "version": "local-signing/v2",
  "status": "approval_required",
  "signingStep": "owner_account_acceptance",
  "challenge": {
    "challenge": "<string>",
    "challengeIdentifier": "<string>",
    "allowCredentials": {
      "key": [
        {
          "type": "public-key",
          "id": "<string>"
        }
      ],
      "webauthn": [
        {
          "type": "public-key",
          "id": "<string>"
        }
      ]
    },
    "userVerification": "required"
  },
  "deposit": {
    "version": "local-signing/v2",
    "environment": "local",
    "adminCommandId": "<string>",
    "fundingIntentId": "<string>",
    "depositId": "<string>",
    "engineCommandId": "<string>",
    "accountId": "<string>",
    "partyId": "<string>",
    "asset": "USD.E",
    "amountAtoms": "<string>",
    "plannedCantonCommands": [
      {
        "step": "treasury_offer",
        "commandId": "<string>"
      }
    ],
    "status": "bound"
  }
}

{
  "version": "external-rest-error/v1",
  "requestId": "<string>",
  "code": "invalid_request",
  "safeMessage": "<string>",
  "retryable": true,
  "recoveryActions": [
    "none"
  ],
  "occurredAtEpochMs": 1,
  "realtimeTicketFailure": "invalid"
}

{
  "version": "external-rest-error/v1",
  "requestId": "<string>",
  "code": "invalid_request",
  "safeMessage": "<string>",
  "retryable": true,
  "recoveryActions": [
    "none"
  ],
  "occurredAtEpochMs": 1,
  "realtimeTicketFailure": "invalid"
}

{
  "version": "external-rest-error/v1",
  "requestId": "<string>",
  "code": "invalid_request",
  "safeMessage": "<string>",
  "retryable": true,
  "recoveryActions": [
    "none"
  ],
  "occurredAtEpochMs": 1,
  "realtimeTicketFailure": "invalid"
}

{
  "version": "external-rest-error/v1",
  "requestId": "<string>",
  "code": "invalid_request",
  "safeMessage": "<string>",
  "retryable": true,
  "recoveryActions": [
    "none"
  ],
  "occurredAtEpochMs": 1,
  "realtimeTicketFailure": "invalid"
}

Accounts

Authorize a DFNS-signed Canton deposit

Drives the next owner-authorized Canton command. Initiate returns a DFNS WebAuthn challenge; complete consumes that exact assertion, executes the immutable prepared transaction, and advances until the second owner approval or final ledger receipt. Prepared transactions, hashes, signatures, and bearer material remain server-only.

Method and path: POST /v1/accounts//deposits/confirm

Authentication: DFNS trader bearer required.

Request schema: DfnsDepositConfirmRequest.

Response schema: DfnsDepositConfirmResponse.

Error envelope: ExternalRestError (external-rest-error/v1).

POST

accounts

{accountId}

deposits

confirm

Error

A valid request URL is required to generate request examples

{
  "version": "local-signing/v2",
  "status": "approval_required",
  "signingStep": "owner_account_acceptance",
  "challenge": {
    "challenge": "<string>",
    "challengeIdentifier": "<string>",
    "allowCredentials": {
      "key": [
        {
          "type": "public-key",
          "id": "<string>"
        }
      ],
      "webauthn": [
        {
          "type": "public-key",
          "id": "<string>"
        }
      ]
    },
    "userVerification": "required"
  },
  "deposit": {
    "version": "local-signing/v2",
    "environment": "local",
    "adminCommandId": "<string>",
    "fundingIntentId": "<string>",
    "depositId": "<string>",
    "engineCommandId": "<string>",
    "accountId": "<string>",
    "partyId": "<string>",
    "asset": "USD.E",
    "amountAtoms": "<string>",
    "plannedCantonCommands": [
      {
        "step": "treasury_offer",
        "commandId": "<string>"
      }
    ],
    "status": "bound"
  }
}

{
  "version": "external-rest-error/v1",
  "requestId": "<string>",
  "code": "invalid_request",
  "safeMessage": "<string>",
  "retryable": true,
  "recoveryActions": [
    "none"
  ],
  "occurredAtEpochMs": 1,
  "realtimeTicketFailure": "invalid"
}

{
  "version": "external-rest-error/v1",
  "requestId": "<string>",
  "code": "invalid_request",
  "safeMessage": "<string>",
  "retryable": true,
  "recoveryActions": [
    "none"
  ],
  "occurredAtEpochMs": 1,
  "realtimeTicketFailure": "invalid"
}

{
  "version": "external-rest-error/v1",
  "requestId": "<string>",
  "code": "invalid_request",
  "safeMessage": "<string>",
  "retryable": true,
  "recoveryActions": [
    "none"
  ],
  "occurredAtEpochMs": 1,
  "realtimeTicketFailure": "invalid"
}

{
  "version": "external-rest-error/v1",
  "requestId": "<string>",
  "code": "invalid_request",
  "safeMessage": "<string>",
  "retryable": true,
  "recoveryActions": [
    "none"
  ],
  "occurredAtEpochMs": 1,
  "realtimeTicketFailure": "invalid"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

accountId

string

required

Minimum string length: 1

Body

application/json

Option 1
Option 2

action

string

required

Allowed value: "initiate"

depositId

string

required

Minimum string length: 1

Response

Success

version

string

required

Allowed value: "local-signing/v2"

status

string

required

Allowed value: "approval_required"

signingStep

enum<string>

required

Available options:

owner_account_acceptance,

owner_offer_acceptance,

owner_deposit_authorization

challenge

object

required

Show child attributes

deposit

object

required

Show child attributes

Account policy

External REST API

Authorize a DFNS-signed Canton deposit

Authorizations

Path Parameters

Body

Response