Sign a transaction with a WaaS wallet and broadcast it

Opens a signing room and returns the transaction record. Once signing finishes, Dynamic assembles the transaction and broadcasts it; the signed transaction is never returned. Repeating the idempotency key with the same transaction returns the original record.

POST /sdk/{environmentId}/waas/{walletId}/signAndBroadcast

Sign a transaction with a WaaS wallet and broadcast it

cURL

curl --request POST \
  --url https://app.dynamicauth.com/api/v0/sdk/{environmentId}/waas/{walletId}/signAndBroadcast \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-idempotency-key: <x-idempotency-key>' \
  --data '
{
  "message": "<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"
  },
  "networkId": "<string>",
  "broadcastOptions": {
    "cosignerSignatures": [
      {
        "publicKey": "<string>",
        "signature": "<string>"
      }
    ],
    "skipPreflight": false
  },
  "isFormatted": true,
  "requestedCertainty": "safe",
  "externalReference": "<string>",
  "roomId": "<string>",
  "shareSetId": "95b11417-f18f-457f-8804-68e361f9164f"
}
'

200

{
  "transactionId": "95b11417-f18f-457f-8804-68e361f9164f",
  "status": "pending_signature",
  "chainType": "evm",
  "chainId": "<string>",
  "walletAddress": "<string>",
  "idempotencyKey": "<string>",
  "requestedAt": "2023-11-07T05:31:56Z",
  "reason": "never_sent",
  "errorMessage": "<string>",
  "revertReason": "<string>",
  "externalReference": "<string>",
  "transactionHash": "<string>",
  "blockExplorerUrls": [
    "<string>"
  ],
  "nonce": "<string>",
  "replacementFee": {
    "gasPrice": "<string>",
    "maxFeePerGas": "<string>",
    "maxPriorityFeePerGas": "<string>"
  },
  "room": {
    "roomId": "<string>",
    "serverKeygenIds": [
      "<string>"
    ],
    "newServerKeygenIds": [
      "<string>"
    ],
    "walletId": "95b11417-f18f-457f-8804-68e361f9164f"
  },
  "progress": {
    "reached": 1,
    "required": 2,
    "elapsedSeconds": 1,
    "detail": {
      "evm": {
        "confirmations": 1,
        "requiredConfirmations": 2
      },
      "svm": {
        "commitment": "processed",
        "requiredCommitment": "processed"
      }
    }
  },
  "completedAt": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization · string · header · required

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

Headers

x-idempotency-key · string · required

Your repeat-protection key for one transaction, unique per environment. Repeating it with the same transaction returns the original; with a different transaction, 409.

Required string length: 1 - 255

Pattern: ^[-A-Za-z0-9._~!$&'()*+,;=:@/]{1,255}$

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"

walletId · string · required

UUID of the wallet

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

message · string · required

A string with a max length of 204800 characters

Maximum string length: 204800

context · object · required

Show child attributes

networkId · string · required

Network the transaction is sent on (e.g. "1", "101"). The context must name the same chain id.

Pattern: ^[0-9]{1,20}$

broadcastOptions · object

How to send the signed transaction. Solana only.

Show child attributes

isFormatted · boolean

When true, message is treated as a pre-computed 32-byte hash (64 hex characters, optionally with a leading 0x) and signed by the MPC server as-is ("raw signing"). When false or omitted, the SDK hashes the message bytes using the chain's standard algorithm (e.g. keccak256 for EVM). Sign and broadcast only accepts false.

requestedCertainty · string · default: safe

How sure to be before calling the transaction confirmed. fast, safe or final, or chain: followed by the chain's own value, such as chain:12 or chain:finalized.

Maximum string length: 64

Pattern: ^(fast|safe|final|chain:[a-z0-9]{1,58})$

externalReference · string

Your own label for this transaction, returned on every event. Not unique.

Required string length: 1 - 256

Pattern: ^[\x20-\x7E]+$

roomId · string

MPC room identifier for the signing session

Maximum string length: 255

Pattern: ^[A-Za-z0-9_-]+$

approvalQuorum · object

Signing-quorum consent evidence for a business-account-governed sign — the Initiator's own signed Intent (or, when redeeming a stored proposal from a non-Initiator session, initiatorProof instead). A top-level sibling of context, never nested under it — context describes only the operation being signed. Approvals collected from other members are tracked server-side against the proposal, never sent by a client. intentSignature is required when first submitting an initiator-signed intent. It is omitted when redeeming an existing proposal, where the server matches the exact intent and restores the stored initiator signature.

Show child attributes

shareSetId · string

Optional identifier of the share set this operation targets. When omitted, the active rootUser share set for walletId is resolved server-side (backwards-compat fallback for older SDKs).

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"

Response

200

application/json

The transaction record, with the signing room while signing is pending

transactionId · string · required

Dynamic's id for this transaction, the same on every event.

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"

status · enum<string> · required

Where the transaction has got to. stalled means nobody is pushing it any more and it can return to confirming. Tolerate values you do not recognise.

Available options: pending_signature, signed, broadcasting, confirming, stalled, completed, reverted, failed

chainType · enum<string> · required

Available options: evm, svm

chainId · string · required

An EVM chain id, or a Solana network id (101 mainnet, 103 devnet, 201 Eclipse).

walletAddress · string · required

idempotencyKey · string · required

The key the transaction was requested with.

requestedAt · string<date-time> · required

reason · enum<string>

Why a transaction failed or stalled. Tolerate values you do not recognise.

Available options: never_sent, rejected, expired, replaced, nonce_gap, ceremony_failed, assembly_failed, storage_failed, insufficient_funds, broadcaster_stopped, broadcaster_failed

errorMessage · string

Human-readable detail on a reverted or failed transaction, written by Dynamic and never a raw provider or node error. For a log or a support ticket; branch on reason instead.

Maximum string length: 512

revertReason · string

The contract's own error, when the transaction landed and reverted. Public chain output, passed through untouched and capped in length.

Maximum string length: 512

externalReference · string

Your own label, as sent.

transactionHash · string

The transaction's hash, once it is signed.

blockExplorerUrls · string<uri>[]

Maximum string length: 2048

nonce · string

EVM only. The transaction's nonce, the only safe one to reuse when replacing it.

Pattern: ^0x(0|[1-9a-fA-F][0-9a-fA-F]{0,63})$

replacementFee · object

EVM only, while the transaction is not final. The lowest fee a replacement at the same nonce would need to displace the transaction.

Show child attributes

room · object

The signing room, while status is pending_signature.

Show child attributes

progress · object

Show child attributes

completedAt · string<date-time>

Present when the status is terminal.