SDK — propose a signing-quorum transaction for a business-account wallet

Opens a signMessage proposal for the wallet’s caller-signed intent without running the sign.

POST /sdk/{environmentId}/businessAccounts/{businessAccountId}/wallets/{walletId}/signingProposals

SDK — propose a signing-quorum transaction for a business-account wallet

cURL

curl --request POST \
  --url https://app.dynamicauth.com/api/v0/sdk/{environmentId}/businessAccounts/{businessAccountId}/wallets/{walletId}/signingProposals \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "message": "<string>",
  "approvalQuorum": {
    "intent": {
      "intentId": "95b11417-f18f-457f-8804-68e361f9164f",
      "businessAccountId": "95b11417-f18f-457f-8804-68e361f9164f",
      "accountAddress": "0xbF394748301603f18d953C90F0b087CBEC0E1834",
      "actionType": "waasSigningQuorumApprove",
      "initiatorUserId": "95b11417-f18f-457f-8804-68e361f9164f",
      "createdAt": "<string>",
      "operation": {
        "kind": "<string>",
        "chainName": "<string>",
        "message": "<string>",
        "payload": "<string>"
      },
      "completeBy": "<string>"
    },
    "intentSignature": "<string>",
    "initiatorProof": "<string>"
  },
  "context": {
    "evmUserOperation": {
      "chainId": 123,
      "entryPoint": "<string>",
      "operation": {
        "authorization": {
          "address": "<string>",
          "chainId": 123,
          "nonce": 123,
          "r": "<string>",
          "s": "<string>",
          "v": "<string>",
          "yParity": 123
        },
        "callData": "<string>",
        "callGasLimit": "<string>",
        "factory": "<string>",
        "factoryData": "<string>",
        "maxFeePerGas": "<string>",
        "maxPriorityFeePerGas": "<string>",
        "nonce": "<string>",
        "paymaster": "<string>",
        "paymasterData": "<string>",
        "paymasterPostOpGasLimit": "<string>",
        "paymasterVerificationGasLimit": "<string>",
        "preVerificationGas": "<string>",
        "sender": "<string>",
        "signature": "<string>",
        "verificationGasLimit": "<string>"
      }
    },
    "evmMessage": "<string>",
    "svmMessage": "<string>",
    "suiMessage": "<string>",
    "stellarMessage": "<string>",
    "aleoMessage": "<string>",
    "domain": "https://app.xyz.com"
  }
}
'

200

{
  "proposalId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "intent": {
    "intentId": "95b11417-f18f-457f-8804-68e361f9164f",
    "businessAccountId": "95b11417-f18f-457f-8804-68e361f9164f",
    "accountAddress": "0xbF394748301603f18d953C90F0b087CBEC0E1834",
    "actionType": "waasSigningQuorumApprove",
    "initiatorUserId": "95b11417-f18f-457f-8804-68e361f9164f",
    "createdAt": "<string>",
    "operation": {
      "kind": "<string>",
      "chainName": "<string>",
      "message": "<string>",
      "payload": "<string>"
    },
    "completeBy": "<string>",
    "limits": {
      "maxGas": "<string>",
      "maxFeePerGas": "<string>",
      "maxPriorityFeePerGas": "<string>",
      "maxTotalFee": "<string>"
    },
    "lifetime": {
      "refreshable": "blockhash"
    }
  },
  "approvalRequirement": {
    "requirementId": "<string>",
    "required": 123,
    "approved": 123,
    "satisfied": true,
    "unmetMandatoryRoles": [
      "<string>"
    ],
    "eligibleApproverRoles": [
      "<string>"
    ],
    "mandatoryApproverRoles": [
      "<string>"
    ]
  }
}

Authorizations

Authorization · string · header · required

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

Path Parameters

environmentId · string · required

ID of the environment

Required string length: 36

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

Example:

"95b11417-f18f-457f-8804-68e361f9164f"

businessAccountId · string · required

ID of the business account

Required string length: 36

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

Example:

"95b11417-f18f-457f-8804-68e361f9164f"

walletId · string · required

Required string length: 36

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

Example:

"95b11417-f18f-457f-8804-68e361f9164f"

Body

application/json

SDK proposeSigning body. message, context and chain describe the operation being proposed — the same fields the eventual signMessage call carries — while approvalQuorum holds the caller-signed intent over it.

message · string · required

A string with a max length of 204800 characters

Maximum string length: 204800

chain · enum<string> · required

Available options: EVM, MIDNIGHT, SVM, SUI, BTC, TON, STELLAR, TEMPO, ALEO, TRON

approvalQuorum · object · required

The Initiator's own signed Intent over the operation being proposed — the same bundle a governed sign carries in approvalQuorum, except proposing always needs the signature: there is no stored proposal to redeem yet. initiatorProof is issued server-side while the caller's token is live and is never sent by the client.

Show child attributes

context · object

Show child attributes

Response

200

application/json

The opened proposal and what its approvals still need

The signMessage proposal opened for the proposed intent — or the identical open one a retry found — with the requirement its approvals must satisfy. intent is the stored signed intent verbatim: approvers sign THESE bytes, never a re-derived copy.

proposalId · string<uuid> · required

The proposal collecting approvals.

intent · object · required

The client-created signed Intent. The enclave checks its operation against the request's current signing context and MPC message.

Show child attributes

approvalRequirement · object · required

One signing-quorum requirement as wallet-service reports it, plus the approvals already counted toward it on the proposal. The role fields are absent when wallet-service did not report them — never re-derive them client-side.

Show child attributes