SignTransaction

Add cryptographic signatures to a compiled transaction.

Adds one or more Ed25519 signatures to a compiled transaction. Supply either private keys directly or seed+passphrase pairs — never both.

State transitions: COMPILED + all required signers → FULLY_SIGNED. COMPILED + subset of signers → PARTIALLY_SIGNED. PARTIALLY_SIGNED + remaining signers → FULLY_SIGNED. See Transaction Lifecycle for the full state machine.

Private keys are transmitted in plaintext over the gRPC connection. Always use TLS in production. Never call this method over an unencrypted connection with real private keys.

Request

transaction · Transaction (object) · required

Transaction to sign. Must be in COMPILED or PARTIALLY_SIGNED state.

Supply either private_keys or seeds — never both. These are mutually exclusive signing methods.

private_keys · SignWithPrivateKeys (object) — one of

Sign using raw private keys.

Show SignWithPrivateKeys fields

private_keys · string[]

List of Base58-encoded Ed25519 private keys.

seeds · SignWithSeeds (object) — one of

Sign using seed+passphrase pairs for key derivation.

Show SignWithSeeds fields

seeds · KeySeed[]

List of seed+passphrase pairs.

Show KeySeed fields

seed · string

Hex-encoded seed.

passphrase · string

Optional passphrase for key derivation.

Response

transaction · Transaction (object)

Transaction with added signatures. State is PARTIALLY_SIGNED or FULLY_SIGNED depending on how many required signers have signed.

Show Transaction fields

state · TransactionState enum

TRANSACTION_STATE_PARTIALLY_SIGNED (3) or TRANSACTION_STATE_FULLY_SIGNED (4).

signatures · string[]

All signatures collected so far, as Base58-encoded strings.

Code Examples

Go

// Sign with private keys
resp, err := client.SignTransaction(ctx, &transaction_v1.SignTransactionRequest{
    Transaction: compiledTxn,
    SigningMethod: &transaction_v1.SignTransactionRequest_PrivateKeys{
        PrivateKeys: &transaction_v1.SignWithPrivateKeys{
            PrivateKeys: []string{"YourBase58PrivateKey111111111111111111111111111"},
        },
    },
})
if err != nil {
    log.Fatal(err)
}
fmt.Printf("State: %v\n", resp.Transaction.State)