Sign Transaction

Allows the completion of the process that collects all necessary signatures needed to submit a transaction.

When transactions are created through Vulcan Forge endpoints, sometimes the API Key that submits the request does not have access to the private keys for all the managed accounts that are signers on the transaction. Or some of the signers are not managed accounts. In this case the system stores the transaction details offchain and returns a tranaction with a status of PARTIALLY_SIGNED.

To complete the offline signing process for such transactions (only applicable to transactions with a messageLifetimeStrategy=DURABLE_NONCE) this endpoint can be used to either:

sign the transaction offline / offplatform (i.e. outside of the Vulcan Forge system) and provide the generated signature(s) - see the offPlatformSigning field in the request payload.

let the system generate signatures for the signer managed accounts that the API Key that submits this request has access to- see the onPlatformSigning field in the request payload.

Note that by default, if the system determines that all needed signatures have been collected, it will also submit the transaction to the blockchain as part of this same request. If the caller wants to only signatures collected, the submitTxnIfAllSignaturesCollected needs to be set to false.

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location --request PATCH 'https://vf-solana-api.dev.alphaledger.com/api/v1/transactions/sign?svmCluster=SOLANA_DEVNET' \ --header 'x-request-id: f9860f73-a466-41f2-a083-34eeb1cc3a3c' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "itemData": { "transaction": { "onchainId": "string", "offchainId": "string" }, "offPlatformSigning": [ { "account": { "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton", "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a", "offchainReferences": { "alId": "ALFNDPF000153778", "organizationExternalId": "ALT", "accountNumber": "ALT10000233", "code": "some-authority", "type": "WALLET" }, "autoSign": true, "otherTenantOrganizationExternalId": "ALIM", "offPlatform": false }, "signature": "string", "dkgSigning": { "partialSignatures": [ { "mpcPlayerCode": "string", "partialSignature": "string" } ], "sessionId": "string" } } ], "onPlatformSigning": [ { "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton", "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a", "offchainReferences": { "alId": "ALFNDPF000153778", "organizationExternalId": "ALT", "accountNumber": "ALT10000233", "code": "some-authority", "type": "WALLET" }, "autoSign": true, "otherTenantOrganizationExternalId": "ALIM", "offPlatform": false } ], "submitTxnIfAllSignaturesCollected": true }, "tenancyConfig": { "overrideOrganizationExternalId": "ALIM" } }'

{ "success": false, "offchainId": "ee36c656-aa74-4d6a-b23c-332c204cb202", "status": "SIGNED", "onchainId": "5nwo7XvhiVRpJasEzH5r3hGKJqaTxd7qVit3cedFJgESdAPrmawebMJu6fUKRfjXEaivuey7vBsW56xPxX76T1bm", "confirmationsCount": 2, "serializedMessage": "string", "errorMessage": "string", "txnTimestamp": "2025-10-21T16:17:45.035372Z" }

Request

Responses