Struct TransactionApi 

pub struct TransactionApi;

Implementations

impl TransactionApi

pub fn create_multisig( &self, signers: Signers, threshold: Threshold, nonce: Nonce, ) -> StaticPayload<CreateMultisig>

Create a new multisig account with deterministic address

Parameters:

• signers: List of accounts that can sign for this multisig
• threshold: Number of approvals required to execute transactions
• nonce: User-provided nonce for address uniqueness

The multisig address is deterministically derived from: hash(pallet_id || sorted_signers || threshold || nonce)

Signers are automatically sorted before hashing, so order doesn’t matter.

Economic costs:

• MultisigFee: burned immediately (spam prevention)
• MultisigDeposit: reserved until dissolution, then returned to creator (storage bond)

pub fn propose( &self, multisig_address: MultisigAddress, call: Call, expiry: Expiry, ) -> StaticPayload<Propose>

Propose a transaction to be executed by the multisig

Parameters:

• multisig_address: The multisig account that will execute the call
• call: The encoded call to execute
• expiry: Block number when this proposal expires

The proposer must be a signer and must pay:

• A deposit (refundable - returned immediately on execution/cancellation)
• A fee (non-refundable, burned immediately)

For threshold=1: The proposal is created with Approved status immediately and can be executed via execute() without additional approvals.

Weight: Charged upfront for worst-case (high-security path with decode). Refunded to actual cost on success based on whether HS path was taken.

pub fn approve( &self, multisig_address: MultisigAddress, proposal_id: ProposalId, ) -> StaticPayload<Approve>

Approve a proposed transaction

If this approval brings the total approvals to or above the threshold, the proposal status changes to Approved and can be executed via execute().

Parameters:

• multisig_address: The multisig account
• proposal_id: ID (nonce) of the proposal to approve

Weight: Charges for MAX call size, refunds based on actual

pub fn cancel( &self, multisig_address: MultisigAddress, proposal_id: ProposalId, ) -> StaticPayload<Cancel>

Cancel a proposed transaction (only by proposer)

Parameters:

• multisig_address: The multisig account
• proposal_id: ID (nonce) of the proposal to cancel

pub fn remove_expired( &self, multisig_address: MultisigAddress, proposal_id: ProposalId, ) -> StaticPayload<RemoveExpired>

Remove expired proposals and return deposits to proposers

Can only be called by signers of the multisig. Removes Active or Approved proposals that have expired (past expiry block). Executed and Cancelled proposals are automatically cleaned up immediately.

Approved+expired proposals can become stuck if proposer is unavailable (e.g. lost keys, compromise). Allowing any signer to remove them prevents permanent deposit lockup and enables multisig dissolution.

The deposit is always returned to the original proposer, not the caller.

pub fn claim_deposits( &self, multisig_address: MultisigAddress, ) -> StaticPayload<ClaimDeposits>

Claim all deposits from expired proposals

This is a batch operation that removes all expired proposals where:

• Caller is the proposer
• Proposal is Active or Approved and past expiry block

Note: Executed and Cancelled proposals are automatically cleaned up immediately, so only Active+Expired and Approved+Expired proposals need manual cleanup.

Returns all proposal deposits to the proposer in a single transaction.

pub fn execute( &self, multisig_address: MultisigAddress, proposal_id: ProposalId, ) -> StaticPayload<Execute>

Execute an approved proposal

Can be called by any signer of the multisig once the proposal has reached the approval threshold (status = Approved). The proposal must not be expired.

On execution:

• The call is decoded and dispatched as the multisig account
• Proposal is removed from storage
• Deposit is returned to the proposer

Parameters:

• multisig_address: The multisig account
• proposal_id: ID (nonce) of the proposal to execute

pub fn approve_dissolve( &self, multisig_address: MultisigAddress, ) -> StaticPayload<ApproveDissolve>

Approve dissolving a multisig account

Signers call this to approve dissolving the multisig. When threshold is reached, the multisig is automatically dissolved.

Requirements:

• Caller must be a signer
• No proposals exist (active, executed, or cancelled) - must be fully cleaned up
• Multisig account balance must be zero

When threshold is reached:

• Deposit is returned to creator
• Multisig storage is removed