@cfxlabsinc/b2b-services
    Preparing search index...

    Class UtilaTransactionClient

    Hierarchy

    • UtilaBaseClient
      • UtilaTransactionClient
    Index
    constructor
    client
    batchGetAssets generateToken get initiateSolanaTransaction list vote
    client: Client<paths>

    • The full asset records behind a set of assets/{asset_id} resource names.

      The second call includeReferencedResources was supposed to make unnecessary — and does, for almost every page. Not every page: vault 29a162977e9e's third backfill page names erc20.avalanche-c-chain-mainnet.0x49D5… in a transfer and ships a 12-asset referencedResources without it, so the walk stalled on a transaction whose decimals nothing could resolve.

      This is therefore the fallback, never the path: the ingest asks Utila for exactly the assets a page referenced and its own map left out. Guessing decimals instead would write a plausible balance, which is the failure UTILA_TRANSACTION_SYNC.md § 3.3 exists to prevent.

      On the transaction client rather than an asset client of its own because transaction ingest is the only caller and both of its call sites — the poll activity and the webhook consumer — already hold this one. vaultId buys nothing but the bearer token; the endpoint itself is global.

      Returns what Utila can describe, and does not fail because it cannot describe everything. Utila rejects the WHOLE batch when a single name is absent from its catalogue — asset not found: [erc20.avalanche-c-chain- mainnet.0x49D5…], which is WETH.e, a token it does not carry even though it carries WAVAX on the same chain. Throwing there would be the wrong gate in the wrong place: § 4.10 makes the utila_asset FK the guarantee, so that UtilaTransactionService.upsertAssets can still resolve an asset a human registered or an earlier page already stored — both invisible to this endpoint. An asset that nothing can resolve still fails, loudly, at the FK.

      Parameters

      • args: { names: string[]; vaultId: string }

      Returns Promise<
          {
              assets?: {
                  convertedValue?: { amount?: string; currencyCode?: string };
                  decimals?: number;
                  displayName?: string;
                  name?: string;
                  network?: string;
                  symbol?: string;
                  tokenInfo?: {
                      cantonTokenDetails?: {
                          instrumentAdmin?: string;
                          instrumentId?: string;
                      };
                      contractAddress?: string;
                      denom?: string;
                      standard?: | "ERC20"
                      | "ERC721"
                      | "ERC1155"
                      | "TRC20"
                      | "SPL_TOKEN"
                      | "SPL_TOKEN_2022"
                      | "ICS20"
                      | "JETTON"
                      | "TIP20";
                      suiTokenDetails?: { gasless?: boolean };
                      tip20Currency?: string;
                  };
                  type?: "NATIVE_CURRENCY"
                  | "TOKEN";
              }[];
          },
      >

    • A Utila service-account JWT for vaultId, cached until shortly before it expires.

      The cache is not an optimisation detail: every call site mints a token per request, and under KMS that would be a kms:Sign network round trip on every Utila API call. It is keyed by vault because the identity is — two vaults mean two subs and therefore two tokens.

      Parameters

      • vaultId: string

      Returns Promise<string>

    • Parameters

      • args: { transactionId: string; vaultId: string }

      Returns Promise<
          {
              referencedAddressesInfo?: {
                  [key: string]: {
                      addressBookEntry?: string;
                      wallet?: string;
                      walletAddress?: string;
                  };
              };
              referencedResources?: {
                  [key: string]: {
                      addressBookEntry?: {
                          address: string;
                          associatedExternalWallet?: string;
                          createTime?: string;
                          creator?: string;
                          displayName: string;
                          name?: string;
                          network: string;
                          note?: string;
                          signed?: boolean;
                          tracked?: boolean;
                      };
                      asset?: {
                          convertedValue?: { amount?: string; currencyCode?: string };
                          decimals?: number;
                          displayName?: string;
                          name?: string;
                          network?: string;
                          symbol?: string;
                          tokenInfo?: {
                              cantonTokenDetails?: { instrumentAdmin?: ...; instrumentId?: ... };
                              contractAddress?: string;
                              denom?: string;
                              standard?:
                                  | "ERC20"
                                  | "ERC721"
                                  | "ERC1155"
                                  | "TRC20"
                                  | "SPL_TOKEN"
                                  | "SPL_TOKEN_2022"
                                  | "ICS20"
                                  | "JETTON"
                                  | "TIP20";
                              suiTokenDetails?: { gasless?: ... };
                              tip20Currency?: string;
                          };
                          type?: "NATIVE_CURRENCY"
                          | "TOKEN";
                      };
                      transaction?: {
                          aleoTransaction?: {
                              feeMicrocredits?: string;
                              feeOperation?: {
                                  amountMicrocredits?: ...;
                                  payer?: ...;
                                  priorityFeeMicrocredits?: ...;
                              };
                              operations?: (...)[];
                          };
                          amlDetails?: {
                              resolved?: boolean;
                              screeningPolicyResult?: "DENY"
                              | "ALLOW"
                              | "ALERT";
                              screeningState?: "FAILED" | "PENDING" | "SKIPPED" | "READY";
                          };
                          aptosTransaction?: {
                              chainId?: string;
                              decodedPayload?: { entryFunction?: ... };
                              expirationTime?: string;
                              gasUnitPrice?: string;
                              maxGasAmount?: string;
                              payloadBytes?: string;
                              sender?: { infoRef?: ...; value?: ... };
                              sequenceNumber?: string;
                          };
                          blockNumber?: string;
                          btcPsbt?: {
                              fee?: string;
                              inputs?: (...)[];
                              outputs?: (...)[];
                              signedPsbt?: string;
                          };
                          btcTransaction?: {
                              asset?: string;
                              fee?: string;
                              inputs?: (...)[];
                              outputs?: (...)[];
                          };
                          confirmTime?: string;
                          createTime?: string;
                          designatedSigners?: string[];
                          direction?: "INCOMING"
                          | "OUTGOING";
                          evmAccountDelegation?: {
                              chainId?: string;
                              contractAddress?: { infoRef?: ...; value?: ... };
                              nonce?: string;
                              offsetNonce?: boolean;
                              providedNonce?: string;
                              signature?: string;
                              signerAddress?: { infoRef?: ...; value?: ... };
                          };
                          evmMessage?: {
                              message?: string;
                              signature?: string;
                              type?: "PERSONAL_SIGN"
                              | "SIGN_TYPED_DATA_V4";
                          };
                          evmTransaction?: {
                              authorizationDetails?: { authorizationList?: ... };
                              data?: string;
                              fee?: {
                                  gasLimit?: ...;
                                  gasPrice?: ...;
                                  gasUsed?: ...;
                                  maxFeePerGas?: ...;
                                  maxPriorityFeePerGas?: ...;
                              };
                              fromAddress?: { infoRef?: ...; value?: ... };
                              nonce?: string;
                              providedNonce?: string;
                              signature?: string;
                              toAddress?: { infoRef?: ...; value?: ... };
                              value?: string;
                          };
                          expireTime?: string;
                          gasStationOrder?: string;
                          hash?: string;
                          mineTime?: string;
                          name?: string;
                          network?: string;
                          note?: string;
                          replacementTransaction?: string;
                          request?: {
                              approveTime?: string;
                              blockingTransaction?: string;
                              cancelTime?: string;
                              dappInfo?: { url?: ... };
                              declineTime?: string;
                              dropTime?: string;
                              expireTime?: string;
                              externalId?: string;
                              failTime?: string;
                              initiator?: string;
                              name?: string;
                              origin?: "WALLET_CONNECT" | "EXTENSION";
                              publish?: boolean;
                              publishTime?: string;
                              signingSessions?: (...)[];
                              signTime?: string;
                              sourceWallet?: string;
                              transactionBundle?: string;
                              walletconnectSession?: string;
                          };
                          signingSession?: string;
                          solanaSignMessage?: {
                              message?: string;
                              signature?: string;
                              signer?: { infoRef?: ...; value?: ... };
                          };
                          solanaTransaction?: {
                              fee?: string;
                              rawTransaction?: string;
                              replaceBlockhash?: boolean;
                              utilaSigners?: (...)[];
                          };
                          spam?: boolean;
                          state?: | "DECLINED"
                          | "FAILED"
                          | "EXPIRED"
                          | "AWAITING_APPROVAL"
                          | "AWAITING_AML_POLICY_CHECK"
                          | "DECLINED_BY_AML_POLICY"
                          | "AWAITING_POLICY_CHECK"
                          | "AWAITING_SIGNATURE"
                          | "SIGNED"
                          | "AWAITING_PUBLISH"
                          | "PUBLISHED"
                          | "MINED"
                          | "MINED_FAILED"
                          | "REPLACED"
                          | "CANCELED"
                          | "DROPPED"
                          | "CONFIRMED";
                          stellarTransaction?: {
                              fee?: string;
                              memo?: { data: ...; type: ... };
                              operations?: (...)[];
                              rawXdrEnvelope?: string;
                              sequenceNumber?: string;
                              sourceAccountAddress?: { infoRef?: ...; value?: ... };
                              timeBounds?: { maxUnixTime?: ...; minUnixTime?: ... };
                          };
                          substrateTransaction?: {
                              call?: {
                                  args?: ...;
                                  method?: ...;
                                  methodIndex?: ...;
                                  pallet?: ...;
                                  palletIndex?: ...;
                              };
                              encodedCall?: string;
                              fromAddress?: { infoRef?: ...; value?: ... };
                              genesisHash?: string;
                              nonce?: string;
                          };
                          subType?: | "NATIVE_TRANSFER"
                          | "TOKEN_TRANSFER"
                          | "NON_FUNGIBLE_TOKEN_TRANSFER"
                          | "TOKEN_APPROVAL"
                          | "PERSONAL_SIGN"
                          | "SIGN_TYPED_DATA"
                          | "EVM_ACCOUNT_DELEGATION"
                          | "CONTRACT_CALL"
                          | "NATIVE_MULTI_TRANSFER"
                          | "NON_FUNGIBLE_TOKEN_APPROVAL"
                          | "CONNECTION_TRANSFER"
                          | "BATCH_TRANSFER"
                          | "TOKEN_MINT"
                          | "TOKEN_BURN"
                          | "PROGRAM_CALL"
                          | "CONTRACT_DEPLOYMENT"
                          | "TON_PROOF"
                          | "TON_SIGN_DATA"
                          | "SOLANA_SIGN_MESSAGE"
                          | "GENERIC_TRANSACTION"
                          | "CHANGE_TRUST"
                          | "CANTON_TOPOLOGY_TRANSACTION"
                          | "CANTON_TRANSFER_AUTO_APPROVAL"
                          | "CANTON_ACCEPT_TRANSFER_OFFER"
                          | "SUBMITTING_TRANSACTION"
                          | "BTC_PSBT"
                          | "BTC_TRANSFER"
                          | "BTC_SIGN_MESSAGE"
                          | "SHIELD"
                          | "UNSHIELD"
                          | "ALEO_CONSOLIDATE";
                          suiSignPersonalMessage?: {
                              message?: string;
                              signature?: string;
                              signer?: { infoRef?: ...; value?: ... };
                          };
                          suiTransaction?: {
                              decodedTransaction?: string;
                              expirationEpoch?: string;
                              gasBudget?: string;
                              gasPrice?: string;
                              sender?: { infoRef?: ...; value?: ... };
                              txBcsBytes?: string;
                          };
                          thetaTransaction?: {
                              sendTransaction?: { fee?: ...; inputs?: ...; outputs?: ... };
                          };
                          tokenAllowances?: {
                              amount?: (...)
                              | (...);
                              approverAddress?: (...) | (...);
                              asset?: (...) | (...);
                              miningPrice?: (...) | (...);
                              spenderAddress?: (...) | (...);
                          }[];
                          tonProof?: {
                              address?: string;
                              appDomain?: string;
                              payload?: string;
                              signature?: string;
                              timestamp?: string;
                          };
                          tonSignData?: {
                              cell?: string;
                              publicKey?: string;
                              schemaCrc?: string;
                              signature?: string;
                              timestamp?: string;
                          };
                          tonTransaction?: {
                              amount?: string;
                              memo?: string;
                              messages?: (...)[];
                              sender?: { infoRef?: ...; value?: ... };
                              seqno?: string;
                              validUntil?: string;
                          };
                          transfers?: {
                              amount?: (...)
                              | (...);
                              asset?: (...) | (...);
                              destinationAddress?: (...) | (...);
                              miningPrice?: (...) | (...);
                              note?: (...) | (...);
                              sourceAddress?: (...) | (...);
                          }[];
                          tronTransaction?: {
                              cancelAllUnfreezeV2?: { ownerAddress?: ... };
                              delegateResource?: {
                                  amount?: ...;
                                  asset?: ...;
                                  lock?: ...;
                                  lockPeriod?: ...;
                                  ownerAddress?: ...;
                                  receiverAddress?: ...;
                                  resource?: ...;
                              };
                              fee?: {
                                  accountActivationFee?: ...;
                                  bandwidth?: ...;
                                  convertedValue?: ...;
                                  energy?: ...;
                                  usedSun?: ...;
                              };
                              freezeBalanceV2?: {
                                  amount?: ...;
                                  asset?: ...;
                                  ownerAddress?: ...;
                                  resource?: ...;
                              };
                              signature?: string;
                              transferContract?: {
                                  amount?: ...;
                                  ownerAddress?: ...;
                                  toAddress?: ...;
                              };
                              triggerSmartContract?: {
                                  callValue?: ...;
                                  contractAddress?: ...;
                                  data?: ...;
                                  ownerAddress?: ...;
                              };
                              undelegateResource?: {
                                  amount?: ...;
                                  asset?: ...;
                                  ownerAddress?: ...;
                                  receiverAddress?: ...;
                                  resource?: ...;
                              };
                              unfreezeBalanceV2?: {
                                  amount?: ...;
                                  asset?: ...;
                                  ownerAddress?: ...;
                                  resource?: ...;
                              };
                              voteWitness?: { ownerAddress?: ...; votes: ... };
                              withdrawBalance?: { ownerAddress?: ... };
                              withdrawExpireUnfreeze?: { ownerAddress?: ... };
                          };
                          type?: "TRANSACTION"
                          | "MESSAGE";
                          xrplTransaction?: { jsonTransactionData?: {} };
                      };
                      user?: {
                          email: string;
                          fullname?: string;
                          name?: string;
                          pictureUri?: string;
                          type?: "USER_ACCOUNT"
                          | "SERVICE_ACCOUNT";
                          vaultContext?: {
                              role?:
                                  | "ADMIN"
                                  | "SIGNER"
                                  | "VIEWER"
                                  | "OWNER"
                                  | "NON_SIGNING_OPERATOR"
                                  | "NON_SIGNING_ADMIN";
                              status?: "PENDING"
                              | "ACTIVE";
                              vaultId?: string;
                          };
                      };
                      wallet?: {
                          archived?: boolean;
                          btcDetails?: { btcNetworkDetails?: (...)[] };
                          convertedValue?: { amount?: string; currencyCode?: string };
                          createParams?: { walletGroups?: (...)[] };
                          displayName: string;
                          evmDetails?: { address?: string };
                          external?: boolean;
                          hasFrozenAssets?: boolean;
                          name?: string;
                          networks: string[];
                          solanaDetails?: { address?: string };
                          tonDetails?: { address?: string };
                          tronDetails?: { address?: string };
                          xrplDetails?: { signingPubKey?: string };
                      };
                      walletAddress?: {
                          address?: string;
                          displayName?: string;
                          format?: | "BITCOIN_P2PKH"
                          | "BITCOIN_P2WPKH"
                          | "EVM"
                          | "TRON_BASE58"
                          | "BASE58"
                          | "TON_NON_BOUNCEABLE"
                          | "SUBSTRATE_58"
                          | "BITCOIN_P2TR";
                          key?: string;
                          keyDerivationPath?: string[];
                          name?: string;
                          network: string;
                          note?: string;
                          type?: "MAIN"
                          | "DEPOSIT"
                          | "CHANGE";
                      };
                      walletconnectSession?: {
                          initiator?: string;
                          name?: string;
                          network?: string;
                          peer?: {
                              description?: string;
                              icon?: string;
                              name?: string;
                              uri?: string;
                          };
                      };
                  };
              };
              transaction?: {
                  aleoTransaction?: {
                      feeMicrocredits?: string;
                      feeOperation?: {
                          amountMicrocredits?: string;
                          payer?: { infoRef?: (...)
                          | (...); value?: (...) | (...) };
                          priorityFeeMicrocredits?: string;
                      };
                      operations?: {
                          asset?: string;
                          internal?: boolean;
                          join?: { inputs?: ...; outputs?: ...; owner?: ... };
                          program?: string;
                          transferPrivate?: {
                              changeAmount?: ...;
                              recipient?: ...;
                              sender?: ...;
                              sentAmount?: ...;
                          };
                          transferPrivateToPublic?: {
                              changeAmount?: ...;
                              recipient?: ...;
                              sender?: ...;
                              sentAmount?: ...;
                          };
                          transferPublic?: { amount?: ...; recipient?: ...; sender?: ... };
                          transferPublicAsSigner?: {
                              amount?: ...;
                              recipient?: ...;
                              signer?: ...;
                          };
                          transferPublicToPrivate?: {
                              amount?: ...;
                              recipient?: ...;
                              sender?: ...;
                          };
                          transition?: string;
                          unknown?: { inputs?: ...; outputs?: ... };
                      }[];
                  };
                  amlDetails?: {
                      resolved?: boolean;
                      screeningPolicyResult?: "DENY"
                      | "ALLOW"
                      | "ALERT";
                      screeningState?: "FAILED" | "PENDING" | "SKIPPED" | "READY";
                  };
                  aptosTransaction?: {
                      chainId?: string;
                      decodedPayload?: {
                          entryFunction?: {
                              arguments: (...)[];
                              function: string;
                              typeArguments: (...)[];
                          };
                      };
                      expirationTime?: string;
                      gasUnitPrice?: string;
                      maxGasAmount?: string;
                      payloadBytes?: string;
                      sender?: { infoRef?: string; value?: string };
                      sequenceNumber?: string;
                  };
                  blockNumber?: string;
                  btcPsbt?: {
                      fee?: string;
                      inputs?: {
                          address?: { infoRef?: ...; value?: ... };
                          amount?: string;
                          signingSession?: string;
                          userSelected?: boolean;
                      }[];
                      outputs?: {
                          address?: { infoRef?: ...; value?: ... };
                          amount?: string;
                          change?: boolean;
                          changeUserSelected?: boolean;
                      }[];
                      signedPsbt?: string;
                  };
                  btcTransaction?: {
                      asset?: string;
                      fee?: string;
                      inputs?: {
                          address?: { infoRef?: ...; value?: ... };
                          amount?: string;
                          signingSession?: string;
                          userSelected?: boolean;
                      }[];
                      outputs?: {
                          address?: { infoRef?: ...; value?: ... };
                          amount?: string;
                          change?: boolean;
                          changeUserSelected?: boolean;
                      }[];
                  };
                  confirmTime?: string;
                  createTime?: string;
                  designatedSigners?: string[];
                  direction?: "INCOMING"
                  | "OUTGOING";
                  evmAccountDelegation?: {
                      chainId?: string;
                      contractAddress?: { infoRef?: string; value?: string };
                      nonce?: string;
                      offsetNonce?: boolean;
                      providedNonce?: string;
                      signature?: string;
                      signerAddress?: { infoRef?: string; value?: string };
                  };
                  evmMessage?: {
                      message?: string;
                      signature?: string;
                      type?: "PERSONAL_SIGN"
                      | "SIGN_TYPED_DATA_V4";
                  };
                  evmTransaction?: {
                      authorizationDetails?: {
                          authorizationList?: {
                              chainId?: ...;
                              contractAddress?: ...;
                              nonce?: ...;
                              signature?: ...;
                              signer?: ...;
                          }[];
                      };
                      data?: string;
                      fee?: {
                          gasLimit?: string;
                          gasPrice?: string;
                          gasUsed?: string;
                          maxFeePerGas?: string;
                          maxPriorityFeePerGas?: string;
                      };
                      fromAddress?: { infoRef?: string; value?: string };
                      nonce?: string;
                      providedNonce?: string;
                      signature?: string;
                      toAddress?: { infoRef?: string; value?: string };
                      value?: string;
                  };
                  expireTime?: string;
                  gasStationOrder?: string;
                  hash?: string;
                  mineTime?: string;
                  name?: string;
                  network?: string;
                  note?: string;
                  replacementTransaction?: string;
                  request?: {
                      approveTime?: string;
                      blockingTransaction?: string;
                      cancelTime?: string;
                      dappInfo?: { url?: string };
                      declineTime?: string;
                      dropTime?: string;
                      expireTime?: string;
                      externalId?: string;
                      failTime?: string;
                      initiator?: string;
                      name?: string;
                      origin?: "WALLET_CONNECT" | "EXTENSION";
                      publish?: boolean;
                      publishTime?: string;
                      signingSessions?: string[];
                      signTime?: string;
                      sourceWallet?: string;
                      transactionBundle?: string;
                      walletconnectSession?: string;
                  };
                  signingSession?: string;
                  solanaSignMessage?: {
                      message?: string;
                      signature?: string;
                      signer?: { infoRef?: string; value?: string };
                  };
                  solanaTransaction?: {
                      fee?: string;
                      rawTransaction?: string;
                      replaceBlockhash?: boolean;
                      utilaSigners?: { infoRef?: string; value?: string }[];
                  };
                  spam?: boolean;
                  state?: | "DECLINED"
                  | "FAILED"
                  | "EXPIRED"
                  | "AWAITING_APPROVAL"
                  | "AWAITING_AML_POLICY_CHECK"
                  | "DECLINED_BY_AML_POLICY"
                  | "AWAITING_POLICY_CHECK"
                  | "AWAITING_SIGNATURE"
                  | "SIGNED"
                  | "AWAITING_PUBLISH"
                  | "PUBLISHED"
                  | "MINED"
                  | "MINED_FAILED"
                  | "REPLACED"
                  | "CANCELED"
                  | "DROPPED"
                  | "CONFIRMED";
                  stellarTransaction?: {
                      fee?: string;
                      memo?: { data: string; type: "TEXT"
                      | "ID"
                      | "HASH"
                      | "RETURN" };
                      operations?: {
                          decodedBody?: {
                              changeTrust?: ...;
                              createAccount?: ...;
                              payment?: ...;
                              sep41Payment?: ...;
                              sep41TokenApproval?: ...;
                          };
                          rawBody?: string;
                          sourceAccountAddress?: { infoRef?: ...; value?: ... };
                      }[];
                      rawXdrEnvelope?: string;
                      sequenceNumber?: string;
                      sourceAccountAddress?: { infoRef?: string; value?: string };
                      timeBounds?: { maxUnixTime?: string; minUnixTime?: string };
                  };
                  substrateTransaction?: {
                      call?: {
                          args?: { name?: ...; type?: ...; value?: ... }[];
                          method?: string;
                          methodIndex?: number;
                          pallet?: string;
                          palletIndex?: number;
                      };
                      encodedCall?: string;
                      fromAddress?: { infoRef?: string; value?: string };
                      genesisHash?: string;
                      nonce?: string;
                  };
                  subType?: | "NATIVE_TRANSFER"
                  | "TOKEN_TRANSFER"
                  | "NON_FUNGIBLE_TOKEN_TRANSFER"
                  | "TOKEN_APPROVAL"
                  | "PERSONAL_SIGN"
                  | "SIGN_TYPED_DATA"
                  | "EVM_ACCOUNT_DELEGATION"
                  | "CONTRACT_CALL"
                  | "NATIVE_MULTI_TRANSFER"
                  | "NON_FUNGIBLE_TOKEN_APPROVAL"
                  | "CONNECTION_TRANSFER"
                  | "BATCH_TRANSFER"
                  | "TOKEN_MINT"
                  | "TOKEN_BURN"
                  | "PROGRAM_CALL"
                  | "CONTRACT_DEPLOYMENT"
                  | "TON_PROOF"
                  | "TON_SIGN_DATA"
                  | "SOLANA_SIGN_MESSAGE"
                  | "GENERIC_TRANSACTION"
                  | "CHANGE_TRUST"
                  | "CANTON_TOPOLOGY_TRANSACTION"
                  | "CANTON_TRANSFER_AUTO_APPROVAL"
                  | "CANTON_ACCEPT_TRANSFER_OFFER"
                  | "SUBMITTING_TRANSACTION"
                  | "BTC_PSBT"
                  | "BTC_TRANSFER"
                  | "BTC_SIGN_MESSAGE"
                  | "SHIELD"
                  | "UNSHIELD"
                  | "ALEO_CONSOLIDATE";
                  suiSignPersonalMessage?: {
                      message?: string;
                      signature?: string;
                      signer?: { infoRef?: string; value?: string };
                  };
                  suiTransaction?: {
                      decodedTransaction?: string;
                      expirationEpoch?: string;
                      gasBudget?: string;
                      gasPrice?: string;
                      sender?: { infoRef?: string; value?: string };
                      txBcsBytes?: string;
                  };
                  thetaTransaction?: {
                      sendTransaction?: {
                          fee?: { tfuelWei?: (...)
                          | (...); thetaWei?: (...) | (...) };
                          inputs?: { address?: ...; coins?: ... }[];
                          outputs?: { address?: ...; coins?: ... }[];
                      };
                  };
                  tokenAllowances?: {
                      amount?: string;
                      approverAddress?: { infoRef?: string; value?: string };
                      asset?: string;
                      miningPrice?: { amount?: string; currencyCode?: string };
                      spenderAddress?: { infoRef?: string; value?: string };
                  }[];
                  tonProof?: {
                      address?: string;
                      appDomain?: string;
                      payload?: string;
                      signature?: string;
                      timestamp?: string;
                  };
                  tonSignData?: {
                      cell?: string;
                      publicKey?: string;
                      schemaCrc?: string;
                      signature?: string;
                      timestamp?: string;
                  };
                  tonTransaction?: {
                      amount?: string;
                      memo?: string;
                      messages?: {
                          address: string;
                          amount: string;
                          payload?: string;
                          stateInit?: string;
                      }[];
                      sender?: { infoRef?: string; value?: string };
                      seqno?: string;
                      validUntil?: string;
                  };
                  transfers?: {
                      amount?: string;
                      asset?: string;
                      destinationAddress?: { infoRef?: string; value?: string };
                      miningPrice?: { amount?: string; currencyCode?: string };
                      note?: string;
                      sourceAddress?: { infoRef?: string; value?: string };
                  }[];
                  tronTransaction?: {
                      cancelAllUnfreezeV2?: {
                          ownerAddress?: { infoRef?: (...)
                          | (...); value?: (...) | (...) };
                      };
                      delegateResource?: {
                          amount?: string;
                          asset?: string;
                          lock?: boolean;
                          lockPeriod?: string;
                          ownerAddress?: { infoRef?: (...)
                          | (...); value?: (...) | (...) };
                          receiverAddress?: { infoRef?: (...) | (...); value?: (...) | (...) };
                          resource?: "BANDWIDTH" | "ENERGY";
                      };
                      fee?: {
                          accountActivationFee?: {
                              convertedFee?: (...)
                              | (...);
                              fee?: (...) | (...);
                          };
                          bandwidth?: {
                              burned?: (...)
                              | (...);
                              consumed?: (...) | (...);
                              convertedBurned?: (...) | (...);
                          };
                          convertedValue?: {
                              amount?: (...)
                              | (...);
                              currencyCode?: (...) | (...);
                          };
                          energy?: {
                              burned?: (...)
                              | (...);
                              consumed?: (...) | (...);
                              convertedBurned?: (...) | (...);
                          };
                          usedSun?: string;
                      };
                      freezeBalanceV2?: {
                          amount?: string;
                          asset?: string;
                          ownerAddress?: { infoRef?: (...)
                          | (...); value?: (...) | (...) };
                          resource?: "BANDWIDTH" | "ENERGY";
                      };
                      signature?: string;
                      transferContract?: {
                          amount?: string;
                          ownerAddress?: { infoRef?: (...)
                          | (...); value?: (...) | (...) };
                          toAddress?: { infoRef?: (...) | (...); value?: (...) | (...) };
                      };
                      triggerSmartContract?: {
                          callValue?: string;
                          contractAddress?: { infoRef?: (...)
                          | (...); value?: (...) | (...) };
                          data?: string;
                          ownerAddress?: { infoRef?: (...) | (...); value?: (...) | (...) };
                      };
                      undelegateResource?: {
                          amount?: string;
                          asset?: string;
                          ownerAddress?: { infoRef?: (...)
                          | (...); value?: (...) | (...) };
                          receiverAddress?: { infoRef?: (...) | (...); value?: (...) | (...) };
                          resource?: "BANDWIDTH" | "ENERGY";
                      };
                      unfreezeBalanceV2?: {
                          amount?: string;
                          asset?: string;
                          ownerAddress?: { infoRef?: (...)
                          | (...); value?: (...) | (...) };
                          resource?: "BANDWIDTH" | "ENERGY";
                      };
                      voteWitness?: {
                          ownerAddress?: { infoRef?: (...)
                          | (...); value?: (...) | (...) };
                          votes: { voteAddress?: (...) | (...); voteCount?: (...) | (...) }[];
                      };
                      withdrawBalance?: {
                          ownerAddress?: { infoRef?: (...)
                          | (...); value?: (...) | (...) };
                      };
                      withdrawExpireUnfreeze?: {
                          ownerAddress?: { infoRef?: (...)
                          | (...); value?: (...) | (...) };
                      };
                  };
                  type?: "TRANSACTION"
                  | "MESSAGE";
                  xrplTransaction?: { jsonTransactionData?: {} };
              };
          },
      >

    • Initiate a Solana transaction via Utila MPC signing.

      Submits a serialized Solana transaction for signing by the Utila cosigner. By default, Utila will replace the blockhash with a fresh one and broadcast the transaction after signing.

      Parameters

      • args: {
            chain: UtilaBlockchain;
            designatedSigners?: string[];
            externalId?: string;
            note?: string;
            priority?: "HIGH" | "LOW" | "NORMAL";
            publish?: boolean;
            rawTransaction: string;
            replaceBlockhash?: boolean;
            requestId?: string;
            vaultId: string;
        }
        • chain: UtilaBlockchain
        • OptionaldesignatedSigners?: string[]
        • OptionalexternalId?: string

          Client identifier for workflow correlation. Must be unique per vault.

        • Optionalnote?: string

          A note visible to all vault members

        • Optionalpriority?: "HIGH" | "LOW" | "NORMAL"
        • Optionalpublish?: boolean

          If true, Utila broadcasts after signing. Default: true

        • rawTransaction: string

          Base64-encoded serialized VersionedTransaction

        • OptionalreplaceBlockhash?: boolean

          If true, Utila replaces the blockhash before signing. Default: true

        • OptionalrequestId?: string

          UUID for Utila-side idempotency (60-minute deduplication window)

        • vaultId: string

      Returns Promise<
          {
              referencedAddressesInfo?: {
                  [key: string]: {
                      addressBookEntry?: string;
                      wallet?: string;
                      walletAddress?: string;
                  };
              };
              referencedResources?: {
                  [key: string]: {
                      addressBookEntry?: {
                          address: string;
                          associatedExternalWallet?: string;
                          createTime?: string;
                          creator?: string;
                          displayName: string;
                          name?: string;
                          network: string;
                          note?: string;
                          signed?: boolean;
                          tracked?: boolean;
                      };
                      asset?: {
                          convertedValue?: { amount?: string; currencyCode?: string };
                          decimals?: number;
                          displayName?: string;
                          name?: string;
                          network?: string;
                          symbol?: string;
                          tokenInfo?: {
                              cantonTokenDetails?: { instrumentAdmin?: ...; instrumentId?: ... };
                              contractAddress?: string;
                              denom?: string;
                              standard?:
                                  | "ERC20"
                                  | "ERC721"
                                  | "ERC1155"
                                  | "TRC20"
                                  | "SPL_TOKEN"
                                  | "SPL_TOKEN_2022"
                                  | "ICS20"
                                  | "JETTON"
                                  | "TIP20";
                              suiTokenDetails?: { gasless?: ... };
                              tip20Currency?: string;
                          };
                          type?: "NATIVE_CURRENCY"
                          | "TOKEN";
                      };
                      transaction?: {
                          aleoTransaction?: {
                              feeMicrocredits?: string;
                              feeOperation?: {
                                  amountMicrocredits?: ...;
                                  payer?: ...;
                                  priorityFeeMicrocredits?: ...;
                              };
                              operations?: (...)[];
                          };
                          amlDetails?: {
                              resolved?: boolean;
                              screeningPolicyResult?: "DENY"
                              | "ALLOW"
                              | "ALERT";
                              screeningState?: "FAILED" | "PENDING" | "SKIPPED" | "READY";
                          };
                          aptosTransaction?: {
                              chainId?: string;
                              decodedPayload?: { entryFunction?: ... };
                              expirationTime?: string;
                              gasUnitPrice?: string;
                              maxGasAmount?: string;
                              payloadBytes?: string;
                              sender?: { infoRef?: ...; value?: ... };
                              sequenceNumber?: string;
                          };
                          blockNumber?: string;
                          btcPsbt?: {
                              fee?: string;
                              inputs?: (...)[];
                              outputs?: (...)[];
                              signedPsbt?: string;
                          };
                          btcTransaction?: {
                              asset?: string;
                              fee?: string;
                              inputs?: (...)[];
                              outputs?: (...)[];
                          };
                          confirmTime?: string;
                          createTime?: string;
                          designatedSigners?: string[];
                          direction?: "INCOMING"
                          | "OUTGOING";
                          evmAccountDelegation?: {
                              chainId?: string;
                              contractAddress?: { infoRef?: ...; value?: ... };
                              nonce?: string;
                              offsetNonce?: boolean;
                              providedNonce?: string;
                              signature?: string;
                              signerAddress?: { infoRef?: ...; value?: ... };
                          };
                          evmMessage?: {
                              message?: string;
                              signature?: string;
                              type?: "PERSONAL_SIGN"
                              | "SIGN_TYPED_DATA_V4";
                          };
                          evmTransaction?: {
                              authorizationDetails?: { authorizationList?: ... };
                              data?: string;
                              fee?: {
                                  gasLimit?: ...;
                                  gasPrice?: ...;
                                  gasUsed?: ...;
                                  maxFeePerGas?: ...;
                                  maxPriorityFeePerGas?: ...;
                              };
                              fromAddress?: { infoRef?: ...; value?: ... };
                              nonce?: string;
                              providedNonce?: string;
                              signature?: string;
                              toAddress?: { infoRef?: ...; value?: ... };
                              value?: string;
                          };
                          expireTime?: string;
                          gasStationOrder?: string;
                          hash?: string;
                          mineTime?: string;
                          name?: string;
                          network?: string;
                          note?: string;
                          replacementTransaction?: string;
                          request?: {
                              approveTime?: string;
                              blockingTransaction?: string;
                              cancelTime?: string;
                              dappInfo?: { url?: ... };
                              declineTime?: string;
                              dropTime?: string;
                              expireTime?: string;
                              externalId?: string;
                              failTime?: string;
                              initiator?: string;
                              name?: string;
                              origin?: "WALLET_CONNECT" | "EXTENSION";
                              publish?: boolean;
                              publishTime?: string;
                              signingSessions?: (...)[];
                              signTime?: string;
                              sourceWallet?: string;
                              transactionBundle?: string;
                              walletconnectSession?: string;
                          };
                          signingSession?: string;
                          solanaSignMessage?: {
                              message?: string;
                              signature?: string;
                              signer?: { infoRef?: ...; value?: ... };
                          };
                          solanaTransaction?: {
                              fee?: string;
                              rawTransaction?: string;
                              replaceBlockhash?: boolean;
                              utilaSigners?: (...)[];
                          };
                          spam?: boolean;
                          state?: | "DECLINED"
                          | "FAILED"
                          | "EXPIRED"
                          | "AWAITING_APPROVAL"
                          | "AWAITING_AML_POLICY_CHECK"
                          | "DECLINED_BY_AML_POLICY"
                          | "AWAITING_POLICY_CHECK"
                          | "AWAITING_SIGNATURE"
                          | "SIGNED"
                          | "AWAITING_PUBLISH"
                          | "PUBLISHED"
                          | "MINED"
                          | "MINED_FAILED"
                          | "REPLACED"
                          | "CANCELED"
                          | "DROPPED"
                          | "CONFIRMED";
                          stellarTransaction?: {
                              fee?: string;
                              memo?: { data: ...; type: ... };
                              operations?: (...)[];
                              rawXdrEnvelope?: string;
                              sequenceNumber?: string;
                              sourceAccountAddress?: { infoRef?: ...; value?: ... };
                              timeBounds?: { maxUnixTime?: ...; minUnixTime?: ... };
                          };
                          substrateTransaction?: {
                              call?: {
                                  args?: ...;
                                  method?: ...;
                                  methodIndex?: ...;
                                  pallet?: ...;
                                  palletIndex?: ...;
                              };
                              encodedCall?: string;
                              fromAddress?: { infoRef?: ...; value?: ... };
                              genesisHash?: string;
                              nonce?: string;
                          };
                          subType?: | "NATIVE_TRANSFER"
                          | "TOKEN_TRANSFER"
                          | "NON_FUNGIBLE_TOKEN_TRANSFER"
                          | "TOKEN_APPROVAL"
                          | "PERSONAL_SIGN"
                          | "SIGN_TYPED_DATA"
                          | "EVM_ACCOUNT_DELEGATION"
                          | "CONTRACT_CALL"
                          | "NATIVE_MULTI_TRANSFER"
                          | "NON_FUNGIBLE_TOKEN_APPROVAL"
                          | "CONNECTION_TRANSFER"
                          | "BATCH_TRANSFER"
                          | "TOKEN_MINT"
                          | "TOKEN_BURN"
                          | "PROGRAM_CALL"
                          | "CONTRACT_DEPLOYMENT"
                          | "TON_PROOF"
                          | "TON_SIGN_DATA"
                          | "SOLANA_SIGN_MESSAGE"
                          | "GENERIC_TRANSACTION"
                          | "CHANGE_TRUST"
                          | "CANTON_TOPOLOGY_TRANSACTION"
                          | "CANTON_TRANSFER_AUTO_APPROVAL"
                          | "CANTON_ACCEPT_TRANSFER_OFFER"
                          | "SUBMITTING_TRANSACTION"
                          | "BTC_PSBT"
                          | "BTC_TRANSFER"
                          | "BTC_SIGN_MESSAGE"
                          | "SHIELD"
                          | "UNSHIELD"
                          | "ALEO_CONSOLIDATE";
                          suiSignPersonalMessage?: {
                              message?: string;
                              signature?: string;
                              signer?: { infoRef?: ...; value?: ... };
                          };
                          suiTransaction?: {
                              decodedTransaction?: string;
                              expirationEpoch?: string;
                              gasBudget?: string;
                              gasPrice?: string;
                              sender?: { infoRef?: ...; value?: ... };
                              txBcsBytes?: string;
                          };
                          thetaTransaction?: {
                              sendTransaction?: { fee?: ...; inputs?: ...; outputs?: ... };
                          };
                          tokenAllowances?: {
                              amount?: (...)
                              | (...);
                              approverAddress?: (...) | (...);
                              asset?: (...) | (...);
                              miningPrice?: (...) | (...);
                              spenderAddress?: (...) | (...);
                          }[];
                          tonProof?: {
                              address?: string;
                              appDomain?: string;
                              payload?: string;
                              signature?: string;
                              timestamp?: string;
                          };
                          tonSignData?: {
                              cell?: string;
                              publicKey?: string;
                              schemaCrc?: string;
                              signature?: string;
                              timestamp?: string;
                          };
                          tonTransaction?: {
                              amount?: string;
                              memo?: string;
                              messages?: (...)[];
                              sender?: { infoRef?: ...; value?: ... };
                              seqno?: string;
                              validUntil?: string;
                          };
                          transfers?: {
                              amount?: (...)
                              | (...);
                              asset?: (...) | (...);
                              destinationAddress?: (...) | (...);
                              miningPrice?: (...) | (...);
                              note?: (...) | (...);
                              sourceAddress?: (...) | (...);
                          }[];
                          tronTransaction?: {
                              cancelAllUnfreezeV2?: { ownerAddress?: ... };
                              delegateResource?: {
                                  amount?: ...;
                                  asset?: ...;
                                  lock?: ...;
                                  lockPeriod?: ...;
                                  ownerAddress?: ...;
                                  receiverAddress?: ...;
                                  resource?: ...;
                              };
                              fee?: {
                                  accountActivationFee?: ...;
                                  bandwidth?: ...;
                                  convertedValue?: ...;
                                  energy?: ...;
                                  usedSun?: ...;
                              };
                              freezeBalanceV2?: {
                                  amount?: ...;
                                  asset?: ...;
                                  ownerAddress?: ...;
                                  resource?: ...;
                              };
                              signature?: string;
                              transferContract?: {
                                  amount?: ...;
                                  ownerAddress?: ...;
                                  toAddress?: ...;
                              };
                              triggerSmartContract?: {
                                  callValue?: ...;
                                  contractAddress?: ...;
                                  data?: ...;
                                  ownerAddress?: ...;
                              };
                              undelegateResource?: {
                                  amount?: ...;
                                  asset?: ...;
                                  ownerAddress?: ...;
                                  receiverAddress?: ...;
                                  resource?: ...;
                              };
                              unfreezeBalanceV2?: {
                                  amount?: ...;
                                  asset?: ...;
                                  ownerAddress?: ...;
                                  resource?: ...;
                              };
                              voteWitness?: { ownerAddress?: ...; votes: ... };
                              withdrawBalance?: { ownerAddress?: ... };
                              withdrawExpireUnfreeze?: { ownerAddress?: ... };
                          };
                          type?: "TRANSACTION"
                          | "MESSAGE";
                          xrplTransaction?: { jsonTransactionData?: {} };
                      };
                      user?: {
                          email: string;
                          fullname?: string;
                          name?: string;
                          pictureUri?: string;
                          type?: "USER_ACCOUNT"
                          | "SERVICE_ACCOUNT";
                          vaultContext?: {
                              role?:
                                  | "ADMIN"
                                  | "SIGNER"
                                  | "VIEWER"
                                  | "OWNER"
                                  | "NON_SIGNING_OPERATOR"
                                  | "NON_SIGNING_ADMIN";
                              status?: "PENDING"
                              | "ACTIVE";
                              vaultId?: string;
                          };
                      };
                      wallet?: {
                          archived?: boolean;
                          btcDetails?: { btcNetworkDetails?: (...)[] };
                          convertedValue?: { amount?: string; currencyCode?: string };
                          createParams?: { walletGroups?: (...)[] };
                          displayName: string;
                          evmDetails?: { address?: string };
                          external?: boolean;
                          hasFrozenAssets?: boolean;
                          name?: string;
                          networks: string[];
                          solanaDetails?: { address?: string };
                          tonDetails?: { address?: string };
                          tronDetails?: { address?: string };
                          xrplDetails?: { signingPubKey?: string };
                      };
                      walletAddress?: {
                          address?: string;
                          displayName?: string;
                          format?: | "BITCOIN_P2PKH"
                          | "BITCOIN_P2WPKH"
                          | "EVM"
                          | "TRON_BASE58"
                          | "BASE58"
                          | "TON_NON_BOUNCEABLE"
                          | "SUBSTRATE_58"
                          | "BITCOIN_P2TR";
                          key?: string;
                          keyDerivationPath?: string[];
                          name?: string;
                          network: string;
                          note?: string;
                          type?: "MAIN"
                          | "DEPOSIT"
                          | "CHANGE";
                      };
                      walletconnectSession?: {
                          initiator?: string;
                          name?: string;
                          network?: string;
                          peer?: {
                              description?: string;
                              icon?: string;
                              name?: string;
                              uri?: string;
                          };
                      };
                  };
              };
              transaction?: {
                  aleoTransaction?: {
                      feeMicrocredits?: string;
                      feeOperation?: {
                          amountMicrocredits?: string;
                          payer?: { infoRef?: (...)
                          | (...); value?: (...) | (...) };
                          priorityFeeMicrocredits?: string;
                      };
                      operations?: {
                          asset?: string;
                          internal?: boolean;
                          join?: { inputs?: ...; outputs?: ...; owner?: ... };
                          program?: string;
                          transferPrivate?: {
                              changeAmount?: ...;
                              recipient?: ...;
                              sender?: ...;
                              sentAmount?: ...;
                          };
                          transferPrivateToPublic?: {
                              changeAmount?: ...;
                              recipient?: ...;
                              sender?: ...;
                              sentAmount?: ...;
                          };
                          transferPublic?: { amount?: ...; recipient?: ...; sender?: ... };
                          transferPublicAsSigner?: {
                              amount?: ...;
                              recipient?: ...;
                              signer?: ...;
                          };
                          transferPublicToPrivate?: {
                              amount?: ...;
                              recipient?: ...;
                              sender?: ...;
                          };
                          transition?: string;
                          unknown?: { inputs?: ...; outputs?: ... };
                      }[];
                  };
                  amlDetails?: {
                      resolved?: boolean;
                      screeningPolicyResult?: "DENY"
                      | "ALLOW"
                      | "ALERT";
                      screeningState?: "FAILED" | "PENDING" | "SKIPPED" | "READY";
                  };
                  aptosTransaction?: {
                      chainId?: string;
                      decodedPayload?: {
                          entryFunction?: {
                              arguments: (...)[];
                              function: string;
                              typeArguments: (...)[];
                          };
                      };
                      expirationTime?: string;
                      gasUnitPrice?: string;
                      maxGasAmount?: string;
                      payloadBytes?: string;
                      sender?: { infoRef?: string; value?: string };
                      sequenceNumber?: string;
                  };
                  blockNumber?: string;
                  btcPsbt?: {
                      fee?: string;
                      inputs?: {
                          address?: { infoRef?: ...; value?: ... };
                          amount?: string;
                          signingSession?: string;
                          userSelected?: boolean;
                      }[];
                      outputs?: {
                          address?: { infoRef?: ...; value?: ... };
                          amount?: string;
                          change?: boolean;
                          changeUserSelected?: boolean;
                      }[];
                      signedPsbt?: string;
                  };
                  btcTransaction?: {
                      asset?: string;
                      fee?: string;
                      inputs?: {
                          address?: { infoRef?: ...; value?: ... };
                          amount?: string;
                          signingSession?: string;
                          userSelected?: boolean;
                      }[];
                      outputs?: {
                          address?: { infoRef?: ...; value?: ... };
                          amount?: string;
                          change?: boolean;
                          changeUserSelected?: boolean;
                      }[];
                  };
                  confirmTime?: string;
                  createTime?: string;
                  designatedSigners?: string[];
                  direction?: "INCOMING"
                  | "OUTGOING";
                  evmAccountDelegation?: {
                      chainId?: string;
                      contractAddress?: { infoRef?: string; value?: string };
                      nonce?: string;
                      offsetNonce?: boolean;
                      providedNonce?: string;
                      signature?: string;
                      signerAddress?: { infoRef?: string; value?: string };
                  };
                  evmMessage?: {
                      message?: string;
                      signature?: string;
                      type?: "PERSONAL_SIGN"
                      | "SIGN_TYPED_DATA_V4";
                  };
                  evmTransaction?: {
                      authorizationDetails?: {
                          authorizationList?: {
                              chainId?: ...;
                              contractAddress?: ...;
                              nonce?: ...;
                              signature?: ...;
                              signer?: ...;
                          }[];
                      };
                      data?: string;
                      fee?: {
                          gasLimit?: string;
                          gasPrice?: string;
                          gasUsed?: string;
                          maxFeePerGas?: string;
                          maxPriorityFeePerGas?: string;
                      };
                      fromAddress?: { infoRef?: string; value?: string };
                      nonce?: string;
                      providedNonce?: string;
                      signature?: string;
                      toAddress?: { infoRef?: string; value?: string };
                      value?: string;
                  };
                  expireTime?: string;
                  gasStationOrder?: string;
                  hash?: string;
                  mineTime?: string;
                  name?: string;
                  network?: string;
                  note?: string;
                  replacementTransaction?: string;
                  request?: {
                      approveTime?: string;
                      blockingTransaction?: string;
                      cancelTime?: string;
                      dappInfo?: { url?: string };
                      declineTime?: string;
                      dropTime?: string;
                      expireTime?: string;
                      externalId?: string;
                      failTime?: string;
                      initiator?: string;
                      name?: string;
                      origin?: "WALLET_CONNECT" | "EXTENSION";
                      publish?: boolean;
                      publishTime?: string;
                      signingSessions?: string[];
                      signTime?: string;
                      sourceWallet?: string;
                      transactionBundle?: string;
                      walletconnectSession?: string;
                  };
                  signingSession?: string;
                  solanaSignMessage?: {
                      message?: string;
                      signature?: string;
                      signer?: { infoRef?: string; value?: string };
                  };
                  solanaTransaction?: {
                      fee?: string;
                      rawTransaction?: string;
                      replaceBlockhash?: boolean;
                      utilaSigners?: { infoRef?: string; value?: string }[];
                  };
                  spam?: boolean;
                  state?: | "DECLINED"
                  | "FAILED"
                  | "EXPIRED"
                  | "AWAITING_APPROVAL"
                  | "AWAITING_AML_POLICY_CHECK"
                  | "DECLINED_BY_AML_POLICY"
                  | "AWAITING_POLICY_CHECK"
                  | "AWAITING_SIGNATURE"
                  | "SIGNED"
                  | "AWAITING_PUBLISH"
                  | "PUBLISHED"
                  | "MINED"
                  | "MINED_FAILED"
                  | "REPLACED"
                  | "CANCELED"
                  | "DROPPED"
                  | "CONFIRMED";
                  stellarTransaction?: {
                      fee?: string;
                      memo?: { data: string; type: "TEXT"
                      | "ID"
                      | "HASH"
                      | "RETURN" };
                      operations?: {
                          decodedBody?: {
                              changeTrust?: ...;
                              createAccount?: ...;
                              payment?: ...;
                              sep41Payment?: ...;
                              sep41TokenApproval?: ...;
                          };
                          rawBody?: string;
                          sourceAccountAddress?: { infoRef?: ...; value?: ... };
                      }[];
                      rawXdrEnvelope?: string;
                      sequenceNumber?: string;
                      sourceAccountAddress?: { infoRef?: string; value?: string };
                      timeBounds?: { maxUnixTime?: string; minUnixTime?: string };
                  };
                  substrateTransaction?: {
                      call?: {
                          args?: { name?: ...; type?: ...; value?: ... }[];
                          method?: string;
                          methodIndex?: number;
                          pallet?: string;
                          palletIndex?: number;
                      };
                      encodedCall?: string;
                      fromAddress?: { infoRef?: string; value?: string };
                      genesisHash?: string;
                      nonce?: string;
                  };
                  subType?: | "NATIVE_TRANSFER"
                  | "TOKEN_TRANSFER"
                  | "NON_FUNGIBLE_TOKEN_TRANSFER"
                  | "TOKEN_APPROVAL"
                  | "PERSONAL_SIGN"
                  | "SIGN_TYPED_DATA"
                  | "EVM_ACCOUNT_DELEGATION"
                  | "CONTRACT_CALL"
                  | "NATIVE_MULTI_TRANSFER"
                  | "NON_FUNGIBLE_TOKEN_APPROVAL"
                  | "CONNECTION_TRANSFER"
                  | "BATCH_TRANSFER"
                  | "TOKEN_MINT"
                  | "TOKEN_BURN"
                  | "PROGRAM_CALL"
                  | "CONTRACT_DEPLOYMENT"
                  | "TON_PROOF"
                  | "TON_SIGN_DATA"
                  | "SOLANA_SIGN_MESSAGE"
                  | "GENERIC_TRANSACTION"
                  | "CHANGE_TRUST"
                  | "CANTON_TOPOLOGY_TRANSACTION"
                  | "CANTON_TRANSFER_AUTO_APPROVAL"
                  | "CANTON_ACCEPT_TRANSFER_OFFER"
                  | "SUBMITTING_TRANSACTION"
                  | "BTC_PSBT"
                  | "BTC_TRANSFER"
                  | "BTC_SIGN_MESSAGE"
                  | "SHIELD"
                  | "UNSHIELD"
                  | "ALEO_CONSOLIDATE";
                  suiSignPersonalMessage?: {
                      message?: string;
                      signature?: string;
                      signer?: { infoRef?: string; value?: string };
                  };
                  suiTransaction?: {
                      decodedTransaction?: string;
                      expirationEpoch?: string;
                      gasBudget?: string;
                      gasPrice?: string;
                      sender?: { infoRef?: string; value?: string };
                      txBcsBytes?: string;
                  };
                  thetaTransaction?: {
                      sendTransaction?: {
                          fee?: { tfuelWei?: (...)
                          | (...); thetaWei?: (...) | (...) };
                          inputs?: { address?: ...; coins?: ... }[];
                          outputs?: { address?: ...; coins?: ... }[];
                      };
                  };
                  tokenAllowances?: {
                      amount?: string;
                      approverAddress?: { infoRef?: string; value?: string };
                      asset?: string;
                      miningPrice?: { amount?: string; currencyCode?: string };
                      spenderAddress?: { infoRef?: string; value?: string };
                  }[];
                  tonProof?: {
                      address?: string;
                      appDomain?: string;
                      payload?: string;
                      signature?: string;
                      timestamp?: string;
                  };
                  tonSignData?: {
                      cell?: string;
                      publicKey?: string;
                      schemaCrc?: string;
                      signature?: string;
                      timestamp?: string;
                  };
                  tonTransaction?: {
                      amount?: string;
                      memo?: string;
                      messages?: {
                          address: string;
                          amount: string;
                          payload?: string;
                          stateInit?: string;
                      }[];
                      sender?: { infoRef?: string; value?: string };
                      seqno?: string;
                      validUntil?: string;
                  };
                  transfers?: {
                      amount?: string;
                      asset?: string;
                      destinationAddress?: { infoRef?: string; value?: string };
                      miningPrice?: { amount?: string; currencyCode?: string };
                      note?: string;
                      sourceAddress?: { infoRef?: string; value?: string };
                  }[];
                  tronTransaction?: {
                      cancelAllUnfreezeV2?: {
                          ownerAddress?: { infoRef?: (...)
                          | (...); value?: (...) | (...) };
                      };
                      delegateResource?: {
                          amount?: string;
                          asset?: string;
                          lock?: boolean;
                          lockPeriod?: string;
                          ownerAddress?: { infoRef?: (...)
                          | (...); value?: (...) | (...) };
                          receiverAddress?: { infoRef?: (...) | (...); value?: (...) | (...) };
                          resource?: "BANDWIDTH" | "ENERGY";
                      };
                      fee?: {
                          accountActivationFee?: {
                              convertedFee?: (...)
                              | (...);
                              fee?: (...) | (...);
                          };
                          bandwidth?: {
                              burned?: (...)
                              | (...);
                              consumed?: (...) | (...);
                              convertedBurned?: (...) | (...);
                          };
                          convertedValue?: {
                              amount?: (...)
                              | (...);
                              currencyCode?: (...) | (...);
                          };
                          energy?: {
                              burned?: (...)
                              | (...);
                              consumed?: (...) | (...);
                              convertedBurned?: (...) | (...);
                          };
                          usedSun?: string;
                      };
                      freezeBalanceV2?: {
                          amount?: string;
                          asset?: string;
                          ownerAddress?: { infoRef?: (...)
                          | (...); value?: (...) | (...) };
                          resource?: "BANDWIDTH" | "ENERGY";
                      };
                      signature?: string;
                      transferContract?: {
                          amount?: string;
                          ownerAddress?: { infoRef?: (...)
                          | (...); value?: (...) | (...) };
                          toAddress?: { infoRef?: (...) | (...); value?: (...) | (...) };
                      };
                      triggerSmartContract?: {
                          callValue?: string;
                          contractAddress?: { infoRef?: (...)
                          | (...); value?: (...) | (...) };
                          data?: string;
                          ownerAddress?: { infoRef?: (...) | (...); value?: (...) | (...) };
                      };
                      undelegateResource?: {
                          amount?: string;
                          asset?: string;
                          ownerAddress?: { infoRef?: (...)
                          | (...); value?: (...) | (...) };
                          receiverAddress?: { infoRef?: (...) | (...); value?: (...) | (...) };
                          resource?: "BANDWIDTH" | "ENERGY";
                      };
                      unfreezeBalanceV2?: {
                          amount?: string;
                          asset?: string;
                          ownerAddress?: { infoRef?: (...)
                          | (...); value?: (...) | (...) };
                          resource?: "BANDWIDTH" | "ENERGY";
                      };
                      voteWitness?: {
                          ownerAddress?: { infoRef?: (...)
                          | (...); value?: (...) | (...) };
                          votes: { voteAddress?: (...) | (...); voteCount?: (...) | (...) }[];
                      };
                      withdrawBalance?: {
                          ownerAddress?: { infoRef?: (...)
                          | (...); value?: (...) | (...) };
                      };
                      withdrawExpireUnfreeze?: {
                          ownerAddress?: { infoRef?: (...)
                          | (...); value?: (...) | (...) };
                      };
                  };
                  type?: "TRANSACTION"
                  | "MESSAGE";
                  xrplTransaction?: { jsonTransactionData?: {} };
              };
              transactionId: string;
          },
      >

    • One page of a vault's transactions.

      Deliberately a single page rather than an exhausting iterator: the caller that walks the whole feed has to persist each page before requesting the next one (balances are carried forward, so a page dropped on the floor is a hole in the arithmetic), and that ordering belongs to the caller's transaction, not to the client.

      includeReferencedResources is always on. The response's referencedResources / referencedAddressesInfo siblings are what resolve an asset's decimals and an address's owning wallet with no second call, so a page fetched without them cannot be persisted.

      See docs/proposals/UTILA_TRANSACTION_SYNC.md § 3.5 and § 3.6.

      Parameters

      • args: {
            filter?: string;
            orderBy?: UtilaTransactionOrderBy;
            pageSize?: number;
            pageToken?: string;
            vaultId: string;
        }
        • Optionalfilter?: string

          Utila's filter grammar, e.g. external_id("order-123") or state(CONFIRMED). See https://docs.utila.io/reference/filtering — the supported fields are create_time, state, spam, from_wallet, to_wallet, pending_user_approval, asset and external_id.

        • OptionalorderBy?: UtilaTransactionOrderBy
        • OptionalpageSize?: number

          Utila returns at most 50 when unset, and may return fewer than asked for — so nextPageToken, never a short page, is what says the feed is drained.

        • OptionalpageToken?: string

          The previous page's nextPageToken.

        • vaultId: string

      Returns Promise<
          {
              nextPageToken?: string;
              referencedAddressesInfo?: {
                  [key: string]: {
                      addressBookEntry?: string;
                      wallet?: string;
                      walletAddress?: string;
                  };
              };
              referencedResources?: {
                  [key: string]: {
                      addressBookEntry?: {
                          address: string;
                          associatedExternalWallet?: string;
                          createTime?: string;
                          creator?: string;
                          displayName: string;
                          name?: string;
                          network: string;
                          note?: string;
                          signed?: boolean;
                          tracked?: boolean;
                      };
                      asset?: {
                          convertedValue?: { amount?: string; currencyCode?: string };
                          decimals?: number;
                          displayName?: string;
                          name?: string;
                          network?: string;
                          symbol?: string;
                          tokenInfo?: {
                              cantonTokenDetails?: { instrumentAdmin?: ...; instrumentId?: ... };
                              contractAddress?: string;
                              denom?: string;
                              standard?:
                                  | "ERC20"
                                  | "ERC721"
                                  | "ERC1155"
                                  | "TRC20"
                                  | "SPL_TOKEN"
                                  | "SPL_TOKEN_2022"
                                  | "ICS20"
                                  | "JETTON"
                                  | "TIP20";
                              suiTokenDetails?: { gasless?: ... };
                              tip20Currency?: string;
                          };
                          type?: "NATIVE_CURRENCY"
                          | "TOKEN";
                      };
                      transaction?: {
                          aleoTransaction?: {
                              feeMicrocredits?: string;
                              feeOperation?: {
                                  amountMicrocredits?: ...;
                                  payer?: ...;
                                  priorityFeeMicrocredits?: ...;
                              };
                              operations?: (...)[];
                          };
                          amlDetails?: {
                              resolved?: boolean;
                              screeningPolicyResult?: "DENY"
                              | "ALLOW"
                              | "ALERT";
                              screeningState?: "FAILED" | "PENDING" | "SKIPPED" | "READY";
                          };
                          aptosTransaction?: {
                              chainId?: string;
                              decodedPayload?: { entryFunction?: ... };
                              expirationTime?: string;
                              gasUnitPrice?: string;
                              maxGasAmount?: string;
                              payloadBytes?: string;
                              sender?: { infoRef?: ...; value?: ... };
                              sequenceNumber?: string;
                          };
                          blockNumber?: string;
                          btcPsbt?: {
                              fee?: string;
                              inputs?: (...)[];
                              outputs?: (...)[];
                              signedPsbt?: string;
                          };
                          btcTransaction?: {
                              asset?: string;
                              fee?: string;
                              inputs?: (...)[];
                              outputs?: (...)[];
                          };
                          confirmTime?: string;
                          createTime?: string;
                          designatedSigners?: string[];
                          direction?: "INCOMING"
                          | "OUTGOING";
                          evmAccountDelegation?: {
                              chainId?: string;
                              contractAddress?: { infoRef?: ...; value?: ... };
                              nonce?: string;
                              offsetNonce?: boolean;
                              providedNonce?: string;
                              signature?: string;
                              signerAddress?: { infoRef?: ...; value?: ... };
                          };
                          evmMessage?: {
                              message?: string;
                              signature?: string;
                              type?: "PERSONAL_SIGN"
                              | "SIGN_TYPED_DATA_V4";
                          };
                          evmTransaction?: {
                              authorizationDetails?: { authorizationList?: ... };
                              data?: string;
                              fee?: {
                                  gasLimit?: ...;
                                  gasPrice?: ...;
                                  gasUsed?: ...;
                                  maxFeePerGas?: ...;
                                  maxPriorityFeePerGas?: ...;
                              };
                              fromAddress?: { infoRef?: ...; value?: ... };
                              nonce?: string;
                              providedNonce?: string;
                              signature?: string;
                              toAddress?: { infoRef?: ...; value?: ... };
                              value?: string;
                          };
                          expireTime?: string;
                          gasStationOrder?: string;
                          hash?: string;
                          mineTime?: string;
                          name?: string;
                          network?: string;
                          note?: string;
                          replacementTransaction?: string;
                          request?: {
                              approveTime?: string;
                              blockingTransaction?: string;
                              cancelTime?: string;
                              dappInfo?: { url?: ... };
                              declineTime?: string;
                              dropTime?: string;
                              expireTime?: string;
                              externalId?: string;
                              failTime?: string;
                              initiator?: string;
                              name?: string;
                              origin?: "WALLET_CONNECT" | "EXTENSION";
                              publish?: boolean;
                              publishTime?: string;
                              signingSessions?: (...)[];
                              signTime?: string;
                              sourceWallet?: string;
                              transactionBundle?: string;
                              walletconnectSession?: string;
                          };
                          signingSession?: string;
                          solanaSignMessage?: {
                              message?: string;
                              signature?: string;
                              signer?: { infoRef?: ...; value?: ... };
                          };
                          solanaTransaction?: {
                              fee?: string;
                              rawTransaction?: string;
                              replaceBlockhash?: boolean;
                              utilaSigners?: (...)[];
                          };
                          spam?: boolean;
                          state?: | "DECLINED"
                          | "FAILED"
                          | "EXPIRED"
                          | "AWAITING_APPROVAL"
                          | "AWAITING_AML_POLICY_CHECK"
                          | "DECLINED_BY_AML_POLICY"
                          | "AWAITING_POLICY_CHECK"
                          | "AWAITING_SIGNATURE"
                          | "SIGNED"
                          | "AWAITING_PUBLISH"
                          | "PUBLISHED"
                          | "MINED"
                          | "MINED_FAILED"
                          | "REPLACED"
                          | "CANCELED"
                          | "DROPPED"
                          | "CONFIRMED";
                          stellarTransaction?: {
                              fee?: string;
                              memo?: { data: ...; type: ... };
                              operations?: (...)[];
                              rawXdrEnvelope?: string;
                              sequenceNumber?: string;
                              sourceAccountAddress?: { infoRef?: ...; value?: ... };
                              timeBounds?: { maxUnixTime?: ...; minUnixTime?: ... };
                          };
                          substrateTransaction?: {
                              call?: {
                                  args?: ...;
                                  method?: ...;
                                  methodIndex?: ...;
                                  pallet?: ...;
                                  palletIndex?: ...;
                              };
                              encodedCall?: string;
                              fromAddress?: { infoRef?: ...; value?: ... };
                              genesisHash?: string;
                              nonce?: string;
                          };
                          subType?: | "NATIVE_TRANSFER"
                          | "TOKEN_TRANSFER"
                          | "NON_FUNGIBLE_TOKEN_TRANSFER"
                          | "TOKEN_APPROVAL"
                          | "PERSONAL_SIGN"
                          | "SIGN_TYPED_DATA"
                          | "EVM_ACCOUNT_DELEGATION"
                          | "CONTRACT_CALL"
                          | "NATIVE_MULTI_TRANSFER"
                          | "NON_FUNGIBLE_TOKEN_APPROVAL"
                          | "CONNECTION_TRANSFER"
                          | "BATCH_TRANSFER"
                          | "TOKEN_MINT"
                          | "TOKEN_BURN"
                          | "PROGRAM_CALL"
                          | "CONTRACT_DEPLOYMENT"
                          | "TON_PROOF"
                          | "TON_SIGN_DATA"
                          | "SOLANA_SIGN_MESSAGE"
                          | "GENERIC_TRANSACTION"
                          | "CHANGE_TRUST"
                          | "CANTON_TOPOLOGY_TRANSACTION"
                          | "CANTON_TRANSFER_AUTO_APPROVAL"
                          | "CANTON_ACCEPT_TRANSFER_OFFER"
                          | "SUBMITTING_TRANSACTION"
                          | "BTC_PSBT"
                          | "BTC_TRANSFER"
                          | "BTC_SIGN_MESSAGE"
                          | "SHIELD"
                          | "UNSHIELD"
                          | "ALEO_CONSOLIDATE";
                          suiSignPersonalMessage?: {
                              message?: string;
                              signature?: string;
                              signer?: { infoRef?: ...; value?: ... };
                          };
                          suiTransaction?: {
                              decodedTransaction?: string;
                              expirationEpoch?: string;
                              gasBudget?: string;
                              gasPrice?: string;
                              sender?: { infoRef?: ...; value?: ... };
                              txBcsBytes?: string;
                          };
                          thetaTransaction?: {
                              sendTransaction?: { fee?: ...; inputs?: ...; outputs?: ... };
                          };
                          tokenAllowances?: {
                              amount?: (...)
                              | (...);
                              approverAddress?: (...) | (...);
                              asset?: (...) | (...);
                              miningPrice?: (...) | (...);
                              spenderAddress?: (...) | (...);
                          }[];
                          tonProof?: {
                              address?: string;
                              appDomain?: string;
                              payload?: string;
                              signature?: string;
                              timestamp?: string;
                          };
                          tonSignData?: {
                              cell?: string;
                              publicKey?: string;
                              schemaCrc?: string;
                              signature?: string;
                              timestamp?: string;
                          };
                          tonTransaction?: {
                              amount?: string;
                              memo?: string;
                              messages?: (...)[];
                              sender?: { infoRef?: ...; value?: ... };
                              seqno?: string;
                              validUntil?: string;
                          };
                          transfers?: {
                              amount?: (...)
                              | (...);
                              asset?: (...) | (...);
                              destinationAddress?: (...) | (...);
                              miningPrice?: (...) | (...);
                              note?: (...) | (...);
                              sourceAddress?: (...) | (...);
                          }[];
                          tronTransaction?: {
                              cancelAllUnfreezeV2?: { ownerAddress?: ... };
                              delegateResource?: {
                                  amount?: ...;
                                  asset?: ...;
                                  lock?: ...;
                                  lockPeriod?: ...;
                                  ownerAddress?: ...;
                                  receiverAddress?: ...;
                                  resource?: ...;
                              };
                              fee?: {
                                  accountActivationFee?: ...;
                                  bandwidth?: ...;
                                  convertedValue?: ...;
                                  energy?: ...;
                                  usedSun?: ...;
                              };
                              freezeBalanceV2?: {
                                  amount?: ...;
                                  asset?: ...;
                                  ownerAddress?: ...;
                                  resource?: ...;
                              };
                              signature?: string;
                              transferContract?: {
                                  amount?: ...;
                                  ownerAddress?: ...;
                                  toAddress?: ...;
                              };
                              triggerSmartContract?: {
                                  callValue?: ...;
                                  contractAddress?: ...;
                                  data?: ...;
                                  ownerAddress?: ...;
                              };
                              undelegateResource?: {
                                  amount?: ...;
                                  asset?: ...;
                                  ownerAddress?: ...;
                                  receiverAddress?: ...;
                                  resource?: ...;
                              };
                              unfreezeBalanceV2?: {
                                  amount?: ...;
                                  asset?: ...;
                                  ownerAddress?: ...;
                                  resource?: ...;
                              };
                              voteWitness?: { ownerAddress?: ...; votes: ... };
                              withdrawBalance?: { ownerAddress?: ... };
                              withdrawExpireUnfreeze?: { ownerAddress?: ... };
                          };
                          type?: "TRANSACTION"
                          | "MESSAGE";
                          xrplTransaction?: { jsonTransactionData?: {} };
                      };
                      user?: {
                          email: string;
                          fullname?: string;
                          name?: string;
                          pictureUri?: string;
                          type?: "USER_ACCOUNT"
                          | "SERVICE_ACCOUNT";
                          vaultContext?: {
                              role?:
                                  | "ADMIN"
                                  | "SIGNER"
                                  | "VIEWER"
                                  | "OWNER"
                                  | "NON_SIGNING_OPERATOR"
                                  | "NON_SIGNING_ADMIN";
                              status?: "PENDING"
                              | "ACTIVE";
                              vaultId?: string;
                          };
                      };
                      wallet?: {
                          archived?: boolean;
                          btcDetails?: { btcNetworkDetails?: (...)[] };
                          convertedValue?: { amount?: string; currencyCode?: string };
                          createParams?: { walletGroups?: (...)[] };
                          displayName: string;
                          evmDetails?: { address?: string };
                          external?: boolean;
                          hasFrozenAssets?: boolean;
                          name?: string;
                          networks: string[];
                          solanaDetails?: { address?: string };
                          tonDetails?: { address?: string };
                          tronDetails?: { address?: string };
                          xrplDetails?: { signingPubKey?: string };
                      };
                      walletAddress?: {
                          address?: string;
                          displayName?: string;
                          format?: | "BITCOIN_P2PKH"
                          | "BITCOIN_P2WPKH"
                          | "EVM"
                          | "TRON_BASE58"
                          | "BASE58"
                          | "TON_NON_BOUNCEABLE"
                          | "SUBSTRATE_58"
                          | "BITCOIN_P2TR";
                          key?: string;
                          keyDerivationPath?: string[];
                          name?: string;
                          network: string;
                          note?: string;
                          type?: "MAIN"
                          | "DEPOSIT"
                          | "CHANGE";
                      };
                      walletconnectSession?: {
                          initiator?: string;
                          name?: string;
                          network?: string;
                          peer?: {
                              description?: string;
                              icon?: string;
                              name?: string;
                              uri?: string;
                          };
                      };
                  };
              };
              totalSize?: number;
              transactions?: {
                  aleoTransaction?: {
                      feeMicrocredits?: string;
                      feeOperation?: {
                          amountMicrocredits?: string;
                          payer?: { infoRef?: ...; value?: ... };
                          priorityFeeMicrocredits?: string;
                      };
                      operations?: {
                          asset?: (...)
                          | (...);
                          internal?: (...) | (...) | (...);
                          join?: (...) | (...);
                          program?: (...) | (...);
                          transferPrivate?: (...) | (...);
                          transferPrivateToPublic?: (...) | (...);
                          transferPublic?: (...) | (...);
                          transferPublicAsSigner?: (...) | (...);
                          transferPublicToPrivate?: (...) | (...);
                          transition?: (...) | (...);
                          unknown?: (...) | (...);
                      }[];
                  };
                  amlDetails?: {
                      resolved?: boolean;
                      screeningPolicyResult?: "DENY"
                      | "ALLOW"
                      | "ALERT";
                      screeningState?: "FAILED" | "PENDING" | "SKIPPED" | "READY";
                  };
                  aptosTransaction?: {
                      chainId?: string;
                      decodedPayload?: {
                          entryFunction?: {
                              arguments: ...;
                              function: ...;
                              typeArguments: ...;
                          };
                      };
                      expirationTime?: string;
                      gasUnitPrice?: string;
                      maxGasAmount?: string;
                      payloadBytes?: string;
                      sender?: { infoRef?: string; value?: string };
                      sequenceNumber?: string;
                  };
                  blockNumber?: string;
                  btcPsbt?: {
                      fee?: string;
                      inputs?: {
                          address?: (...)
                          | (...);
                          amount?: (...) | (...);
                          signingSession?: (...) | (...);
                          userSelected?: (...) | (...) | (...);
                      }[];
                      outputs?: {
                          address?: (...)
                          | (...);
                          amount?: (...) | (...);
                          change?: (...) | (...) | (...);
                          changeUserSelected?: (...) | (...) | (...);
                      }[];
                      signedPsbt?: string;
                  };
                  btcTransaction?: {
                      asset?: string;
                      fee?: string;
                      inputs?: {
                          address?: (...)
                          | (...);
                          amount?: (...) | (...);
                          signingSession?: (...) | (...);
                          userSelected?: (...) | (...) | (...);
                      }[];
                      outputs?: {
                          address?: (...)
                          | (...);
                          amount?: (...) | (...);
                          change?: (...) | (...) | (...);
                          changeUserSelected?: (...) | (...) | (...);
                      }[];
                  };
                  confirmTime?: string;
                  createTime?: string;
                  designatedSigners?: string[];
                  direction?: "INCOMING"
                  | "OUTGOING";
                  evmAccountDelegation?: {
                      chainId?: string;
                      contractAddress?: { infoRef?: string; value?: string };
                      nonce?: string;
                      offsetNonce?: boolean;
                      providedNonce?: string;
                      signature?: string;
                      signerAddress?: { infoRef?: string; value?: string };
                  };
                  evmMessage?: {
                      message?: string;
                      signature?: string;
                      type?: "PERSONAL_SIGN"
                      | "SIGN_TYPED_DATA_V4";
                  };
                  evmTransaction?: {
                      authorizationDetails?: { authorizationList?: (...)[] };
                      data?: string;
                      fee?: {
                          gasLimit?: string;
                          gasPrice?: string;
                          gasUsed?: string;
                          maxFeePerGas?: string;
                          maxPriorityFeePerGas?: string;
                      };
                      fromAddress?: { infoRef?: string; value?: string };
                      nonce?: string;
                      providedNonce?: string;
                      signature?: string;
                      toAddress?: { infoRef?: string; value?: string };
                      value?: string;
                  };
                  expireTime?: string;
                  gasStationOrder?: string;
                  hash?: string;
                  mineTime?: string;
                  name?: string;
                  network?: string;
                  note?: string;
                  replacementTransaction?: string;
                  request?: {
                      approveTime?: string;
                      blockingTransaction?: string;
                      cancelTime?: string;
                      dappInfo?: { url?: string };
                      declineTime?: string;
                      dropTime?: string;
                      expireTime?: string;
                      externalId?: string;
                      failTime?: string;
                      initiator?: string;
                      name?: string;
                      origin?: "WALLET_CONNECT" | "EXTENSION";
                      publish?: boolean;
                      publishTime?: string;
                      signingSessions?: string[];
                      signTime?: string;
                      sourceWallet?: string;
                      transactionBundle?: string;
                      walletconnectSession?: string;
                  };
                  signingSession?: string;
                  solanaSignMessage?: {
                      message?: string;
                      signature?: string;
                      signer?: { infoRef?: string; value?: string };
                  };
                  solanaTransaction?: {
                      fee?: string;
                      rawTransaction?: string;
                      replaceBlockhash?: boolean;
                      utilaSigners?: { infoRef?: (...)
                      | (...); value?: (...) | (...) }[];
                  };
                  spam?: boolean;
                  state?: | "DECLINED"
                  | "FAILED"
                  | "EXPIRED"
                  | "AWAITING_APPROVAL"
                  | "AWAITING_AML_POLICY_CHECK"
                  | "DECLINED_BY_AML_POLICY"
                  | "AWAITING_POLICY_CHECK"
                  | "AWAITING_SIGNATURE"
                  | "SIGNED"
                  | "AWAITING_PUBLISH"
                  | "PUBLISHED"
                  | "MINED"
                  | "MINED_FAILED"
                  | "REPLACED"
                  | "CANCELED"
                  | "DROPPED"
                  | "CONFIRMED";
                  stellarTransaction?: {
                      fee?: string;
                      memo?: { data: string; type: "TEXT"
                      | "ID"
                      | "HASH"
                      | "RETURN" };
                      operations?: {
                          decodedBody?: (...) | (...);
                          rawBody?: (...) | (...);
                          sourceAccountAddress?: (...) | (...);
                      }[];
                      rawXdrEnvelope?: string;
                      sequenceNumber?: string;
                      sourceAccountAddress?: { infoRef?: string; value?: string };
                      timeBounds?: { maxUnixTime?: string; minUnixTime?: string };
                  };
                  substrateTransaction?: {
                      call?: {
                          args?: (...)[];
                          method?: string;
                          methodIndex?: number;
                          pallet?: string;
                          palletIndex?: number;
                      };
                      encodedCall?: string;
                      fromAddress?: { infoRef?: string; value?: string };
                      genesisHash?: string;
                      nonce?: string;
                  };
                  subType?: | "NATIVE_TRANSFER"
                  | "TOKEN_TRANSFER"
                  | "NON_FUNGIBLE_TOKEN_TRANSFER"
                  | "TOKEN_APPROVAL"
                  | "PERSONAL_SIGN"
                  | "SIGN_TYPED_DATA"
                  | "EVM_ACCOUNT_DELEGATION"
                  | "CONTRACT_CALL"
                  | "NATIVE_MULTI_TRANSFER"
                  | "NON_FUNGIBLE_TOKEN_APPROVAL"
                  | "CONNECTION_TRANSFER"
                  | "BATCH_TRANSFER"
                  | "TOKEN_MINT"
                  | "TOKEN_BURN"
                  | "PROGRAM_CALL"
                  | "CONTRACT_DEPLOYMENT"
                  | "TON_PROOF"
                  | "TON_SIGN_DATA"
                  | "SOLANA_SIGN_MESSAGE"
                  | "GENERIC_TRANSACTION"
                  | "CHANGE_TRUST"
                  | "CANTON_TOPOLOGY_TRANSACTION"
                  | "CANTON_TRANSFER_AUTO_APPROVAL"
                  | "CANTON_ACCEPT_TRANSFER_OFFER"
                  | "SUBMITTING_TRANSACTION"
                  | "BTC_PSBT"
                  | "BTC_TRANSFER"
                  | "BTC_SIGN_MESSAGE"
                  | "SHIELD"
                  | "UNSHIELD"
                  | "ALEO_CONSOLIDATE";
                  suiSignPersonalMessage?: {
                      message?: string;
                      signature?: string;
                      signer?: { infoRef?: string; value?: string };
                  };
                  suiTransaction?: {
                      decodedTransaction?: string;
                      expirationEpoch?: string;
                      gasBudget?: string;
                      gasPrice?: string;
                      sender?: { infoRef?: string; value?: string };
                      txBcsBytes?: string;
                  };
                  thetaTransaction?: {
                      sendTransaction?: {
                          fee?: { tfuelWei?: ...; thetaWei?: ... };
                          inputs?: (...)[];
                          outputs?: (...)[];
                      };
                  };
                  tokenAllowances?: {
                      amount?: string;
                      approverAddress?: { infoRef?: (...)
                      | (...); value?: (...) | (...) };
                      asset?: string;
                      miningPrice?: { amount?: (...) | (...); currencyCode?: (...) | (...) };
                      spenderAddress?: { infoRef?: (...) | (...); value?: (...) | (...) };
                  }[];
                  tonProof?: {
                      address?: string;
                      appDomain?: string;
                      payload?: string;
                      signature?: string;
                      timestamp?: string;
                  };
                  tonSignData?: {
                      cell?: string;
                      publicKey?: string;
                      schemaCrc?: string;
                      signature?: string;
                      timestamp?: string;
                  };
                  tonTransaction?: {
                      amount?: string;
                      memo?: string;
                      messages?: {
                          address: string;
                          amount: string;
                          payload?: (...)
                          | (...);
                          stateInit?: (...) | (...);
                      }[];
                      sender?: { infoRef?: string; value?: string };
                      seqno?: string;
                      validUntil?: string;
                  };
                  transfers?: {
                      amount?: string;
                      asset?: string;
                      destinationAddress?: { infoRef?: (...)
                      | (...); value?: (...) | (...) };
                      miningPrice?: { amount?: (...) | (...); currencyCode?: (...) | (...) };
                      note?: string;
                      sourceAddress?: { infoRef?: (...) | (...); value?: (...) | (...) };
                  }[];
                  tronTransaction?: {
                      cancelAllUnfreezeV2?: {
                          ownerAddress?: { infoRef?: ...; value?: ... };
                      };
                      delegateResource?: {
                          amount?: string;
                          asset?: string;
                          lock?: boolean;
                          lockPeriod?: string;
                          ownerAddress?: { infoRef?: ...; value?: ... };
                          receiverAddress?: { infoRef?: ...; value?: ... };
                          resource?: "BANDWIDTH" | "ENERGY";
                      };
                      fee?: {
                          accountActivationFee?: { convertedFee?: ...; fee?: ... };
                          bandwidth?: { burned?: ...; consumed?: ...; convertedBurned?: ... };
                          convertedValue?: { amount?: ...; currencyCode?: ... };
                          energy?: { burned?: ...; consumed?: ...; convertedBurned?: ... };
                          usedSun?: string;
                      };
                      freezeBalanceV2?: {
                          amount?: string;
                          asset?: string;
                          ownerAddress?: { infoRef?: ...; value?: ... };
                          resource?: "BANDWIDTH" | "ENERGY";
                      };
                      signature?: string;
                      transferContract?: {
                          amount?: string;
                          ownerAddress?: { infoRef?: ...; value?: ... };
                          toAddress?: { infoRef?: ...; value?: ... };
                      };
                      triggerSmartContract?: {
                          callValue?: string;
                          contractAddress?: { infoRef?: ...; value?: ... };
                          data?: string;
                          ownerAddress?: { infoRef?: ...; value?: ... };
                      };
                      undelegateResource?: {
                          amount?: string;
                          asset?: string;
                          ownerAddress?: { infoRef?: ...; value?: ... };
                          receiverAddress?: { infoRef?: ...; value?: ... };
                          resource?: "BANDWIDTH" | "ENERGY";
                      };
                      unfreezeBalanceV2?: {
                          amount?: string;
                          asset?: string;
                          ownerAddress?: { infoRef?: ...; value?: ... };
                          resource?: "BANDWIDTH" | "ENERGY";
                      };
                      voteWitness?: {
                          ownerAddress?: { infoRef?: ...; value?: ... };
                          votes: { voteAddress?: ...; voteCount?: ... }[];
                      };
                      withdrawBalance?: { ownerAddress?: { infoRef?: ...; value?: ... } };
                      withdrawExpireUnfreeze?: {
                          ownerAddress?: { infoRef?: ...; value?: ... };
                      };
                  };
                  type?: "TRANSACTION"
                  | "MESSAGE";
                  xrplTransaction?: { jsonTransactionData?: {} };
              }[];
          },
      >

    • Cast a vote on a transaction request.

      A transaction request must collect its required approving votes (while in AWAITING_APPROVAL) before it advances to AWAITING_SIGNATURE and becomes eligible for co-signer signing. Voting APPROVE on a request that is no longer awaiting approval is rejected by Utila.

      Parameters

      • args: { transactionRequestId: string; vaultId: string; vote: "APPROVE" | "DENY" }

      Returns Promise<
          {
              transactionState?: | "DECLINED"
              | "FAILED"
              | "EXPIRED"
              | "AWAITING_APPROVAL"
              | "AWAITING_AML_POLICY_CHECK"
              | "DECLINED_BY_AML_POLICY"
              | "AWAITING_POLICY_CHECK"
              | "AWAITING_SIGNATURE"
              | "SIGNED"
              | "AWAITING_PUBLISH"
              | "PUBLISHED"
              | "MINED"
              | "MINED_FAILED"
              | "REPLACED"
              | "CANCELED"
              | "DROPPED"
              | "CONFIRMED";
          },
      >

    Settings
    Member Visibility

    On This Page
    Constructors
    Properties
    Methods