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

    Class UtilaTransactionService

    Writes a Utila transaction and registers the assets it moved.

    The raw per-vault record only: wallet balances and history come from wallet_transaction / wallet_account_transaction, fed by Tatum and Helius.

    See docs/proposals/UTILA_TRANSACTION_SYNC.md § 3.4.

    Index
    constructor
    instance
    countForVault create registeredAssetNames walletAddresses walletIds
    instance: (...args: []) => UtilaTransactionService = ...

    The process default: built from each dependency's own instance().

    • How many transactions this vault has stored — the database half of the § 3.6 count gate.

      Counts utila_transaction, one row per transaction, the unit Utila's totalSize counts. A vault with no wallets of ours still stores the row.

      vaultId is Utila's own vault id; a vault with no row has stored nothing.

      Parameters

      • __namedParameters: { vaultId: string }

      Returns Promise<number>

    • Persist one transaction, idempotently.

      created: false means the row was already there — the unique constraint on (utila_vault_id, utila_id) absorbed the write — which is the normal outcome whenever the webhook fast path and the poll backstop reach the same transaction.

      A transaction that never reached the chain returns created: false with no row, per § 3.1: it moved nothing and cost nothing, so its absence IS its state.

      vaultId is Utila's own vault id, as the feed and the webhook name it.

      Parameters

      • args: {
            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?: {
                                asset?: ...;
                                internal?: ...;
                                join?: ...;
                                program?: ...;
                                transferPrivate?: ...;
                                transferPrivateToPublic?: ...;
                                transferPublic?: ...;
                                transferPublicAsSigner?: ...;
                                transferPublicToPrivate?: ...;
                                transition?: ...;
                                unknown?: ...;
                            }[];
                        };
                        amlDetails?: {
                            resolved?: boolean;
                            screeningPolicyResult?: "DENY"
                            | "ALLOW"
                            | "ALERT";
                            screeningState?: "PENDING" | "FAILED" | "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?: {
                                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?: (...) | (...); 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?: string[];
                            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?: { infoRef?: ...; value?: ... }[];
                        };
                        spam?: boolean;
                        state?: | "FAILED"
                        | "DECLINED"
                        | "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"
                        | "EXPIRED";
                        stellarTransaction?: {
                            fee?: string;
                            memo?: { data: string; type: (...)
                            | (...)
                            | (...)
                            | (...) };
                            operations?: {
                                decodedBody?: ...;
                                rawBody?: ...;
                                sourceAccountAddress?: ...;
                            }[];
                            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?: 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: ...;
                                amount: ...;
                                payload?: ...;
                                stateInit?: ...;
                            }[];
                            sender?: { infoRef?: (...)
                            | (...); value?: (...) | (...) };
                            seqno?: string;
                            validUntil?: string;
                        };
                        transfers?: {
                            amount?: string;
                            asset?: string;
                            destinationAddress?: { infoRef?: ...; value?: ... };
                            miningPrice?: { amount?: ...; currencyCode?: ... };
                            note?: string;
                            sourceAddress?: { infoRef?: ...; value?: ... };
                        }[];
                        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?: Record<string, never> };
                    };
                    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?: { mainAddress?: ...; network?: ...; xpub?: ... }[];
                        };
                        convertedValue?: { amount?: string; currencyCode?: string };
                        createParams?: { walletGroups?: string[] };
                        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?: string; value?: string };
                        priorityFeeMicrocredits?: string;
                    };
                    operations?: {
                        asset?: string;
                        internal?: boolean;
                        join?: {
                            inputs?: (...)[];
                            outputs?: (...)[];
                            owner?: { infoRef?: ...; value?: ... };
                        };
                        program?: string;
                        transferPrivate?: {
                            changeAmount?: string;
                            recipient?: { infoRef?: ...; value?: ... };
                            sender?: { infoRef?: ...; value?: ... };
                            sentAmount?: string;
                        };
                        transferPrivateToPublic?: {
                            changeAmount?: string;
                            recipient?: { infoRef?: ...; value?: ... };
                            sender?: { infoRef?: ...; value?: ... };
                            sentAmount?: string;
                        };
                        transferPublic?: {
                            amount?: string;
                            recipient?: { infoRef?: ...; value?: ... };
                            sender?: { infoRef?: ...; value?: ... };
                        };
                        transferPublicAsSigner?: {
                            amount?: string;
                            recipient?: { infoRef?: ...; value?: ... };
                            signer?: { infoRef?: ...; value?: ... };
                        };
                        transferPublicToPrivate?: {
                            amount?: string;
                            recipient?: { infoRef?: ...; value?: ... };
                            sender?: { infoRef?: ...; value?: ... };
                        };
                        transition?: string;
                        unknown?: { inputs?: (...)[]; outputs?: (...)[] };
                    }[];
                };
                amlDetails?: {
                    resolved?: boolean;
                    screeningPolicyResult?: "DENY"
                    | "ALLOW"
                    | "ALERT";
                    screeningState?: "PENDING" | "FAILED" | "SKIPPED" | "READY";
                };
                aptosTransaction?: {
                    chainId?: string;
                    decodedPayload?: {
                        entryFunction?: {
                            arguments: string[];
                            function: string;
                            typeArguments: string[];
                        };
                    };
                    expirationTime?: string;
                    gasUnitPrice?: string;
                    maxGasAmount?: string;
                    payloadBytes?: string;
                    sender?: { infoRef?: string; value?: string };
                    sequenceNumber?: string;
                };
                blockNumber?: string;
                btcPsbt?: {
                    fee?: string;
                    inputs?: {
                        address?: { infoRef?: string; value?: string };
                        amount?: string;
                        signingSession?: string;
                        userSelected?: boolean;
                    }[];
                    outputs?: {
                        address?: { infoRef?: string; value?: string };
                        amount?: string;
                        change?: boolean;
                        changeUserSelected?: boolean;
                    }[];
                    signedPsbt?: string;
                };
                btcTransaction?: {
                    asset?: string;
                    fee?: string;
                    inputs?: {
                        address?: { infoRef?: string; value?: string };
                        amount?: string;
                        signingSession?: string;
                        userSelected?: boolean;
                    }[];
                    outputs?: {
                        address?: { infoRef?: string; value?: string };
                        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?: string;
                            contractAddress?: { infoRef?: ...; value?: ... };
                            nonce?: string;
                            signature?: string;
                            signer?: { infoRef?: ...; value?: ... };
                        }[];
                    };
                    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?: | "FAILED"
                | "DECLINED"
                | "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"
                | "EXPIRED";
                stellarTransaction?: {
                    fee?: string;
                    memo?: { data: string; type: "TEXT"
                    | "ID"
                    | "HASH"
                    | "RETURN" };
                    operations?: {
                        decodedBody?: {
                            changeTrust?: {
                                asset?: ...;
                                assetRef?: ...;
                                limit?: ...;
                                unlimited?: ...;
                            };
                            createAccount?: { destinationAddress?: ...; startingBalance?: ... };
                            payment?: {
                                amount?: ...;
                                asset?: ...;
                                assetRef?: ...;
                                destinationAddress?: ...;
                            };
                            sep41Payment?: {
                                assetRef?: ...;
                                contractAddress?: ...;
                                destinationAddress?: ...;
                                rawAmount?: ...;
                                sourceAddress?: ...;
                                spenderAddress?: ...;
                            };
                            sep41TokenApproval?: {
                                assetRef?: ...;
                                contractAddress?: ...;
                                liveUntilLedgerNumber?: ...;
                                rawAmount?: ...;
                                sourceAddress?: ...;
                                spenderAddress?: ...;
                            };
                        };
                        rawBody?: string;
                        sourceAccountAddress?: { infoRef?: string; value?: string };
                    }[];
                    rawXdrEnvelope?: string;
                    sequenceNumber?: string;
                    sourceAccountAddress?: { infoRef?: string; value?: string };
                    timeBounds?: { maxUnixTime?: string; minUnixTime?: string };
                };
                substrateTransaction?: {
                    call?: {
                        args?: { name?: string; type?: string; value?: string }[];
                        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?: string; thetaWei?: string };
                        inputs?: {
                            address?: { infoRef?: ...; value?: ... };
                            coins?: { tfuelWei?: ...; thetaWei?: ... };
                        }[];
                        outputs?: {
                            address?: { infoRef?: ...; value?: ... };
                            coins?: { tfuelWei?: ...; thetaWei?: ... };
                        }[];
                    };
                };
                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?: string; value?: string };
                    };
                    delegateResource?: {
                        amount?: string;
                        asset?: string;
                        lock?: boolean;
                        lockPeriod?: string;
                        ownerAddress?: { infoRef?: string; value?: string };
                        receiverAddress?: { infoRef?: string; value?: string };
                        resource?: "BANDWIDTH" | "ENERGY";
                    };
                    fee?: {
                        accountActivationFee?: {
                            convertedFee?: {
                                amount?: (...)
                                | (...);
                                currencyCode?: (...) | (...);
                            };
                            fee?: string;
                        };
                        bandwidth?: {
                            burned?: string;
                            consumed?: string;
                            convertedBurned?: {
                                amount?: (...)
                                | (...);
                                currencyCode?: (...) | (...);
                            };
                        };
                        convertedValue?: { amount?: string; currencyCode?: string };
                        energy?: {
                            burned?: string;
                            consumed?: string;
                            convertedBurned?: {
                                amount?: (...) | (...);
                                currencyCode?: (...) | (...);
                            };
                        };
                        usedSun?: string;
                    };
                    freezeBalanceV2?: {
                        amount?: string;
                        asset?: string;
                        ownerAddress?: { infoRef?: string; value?: string };
                        resource?: "BANDWIDTH" | "ENERGY";
                    };
                    signature?: string;
                    transferContract?: {
                        amount?: string;
                        ownerAddress?: { infoRef?: string; value?: string };
                        toAddress?: { infoRef?: string; value?: string };
                    };
                    triggerSmartContract?: {
                        callValue?: string;
                        contractAddress?: { infoRef?: string; value?: string };
                        data?: string;
                        ownerAddress?: { infoRef?: string; value?: string };
                    };
                    undelegateResource?: {
                        amount?: string;
                        asset?: string;
                        ownerAddress?: { infoRef?: string; value?: string };
                        receiverAddress?: { infoRef?: string; value?: string };
                        resource?: "BANDWIDTH" | "ENERGY";
                    };
                    unfreezeBalanceV2?: {
                        amount?: string;
                        asset?: string;
                        ownerAddress?: { infoRef?: string; value?: string };
                        resource?: "BANDWIDTH" | "ENERGY";
                    };
                    voteWitness?: {
                        ownerAddress?: { infoRef?: string; value?: string };
                        votes: {
                            voteAddress?: { infoRef?: (...) | (...); value?: (...) | (...) };
                            voteCount?: string;
                        }[];
                    };
                    withdrawBalance?: { ownerAddress?: { infoRef?: string; value?: string } };
                    withdrawExpireUnfreeze?: {
                        ownerAddress?: { infoRef?: string; value?: string };
                    };
                };
                type?: "TRANSACTION"
                | "MESSAGE";
                xrplTransaction?: { jsonTransactionData?: Record<string, never> };
            };
            vaultId: string;
        }

      Returns Promise<{ ok: true; value: { created: boolean; feeUnresolved: boolean } }>

      when no b2b.utila_vault row holds vaultId; retry once it does.

    • Which of these assets/{asset_id} names the registry already describes.

      Lets withResolvedUtilaAssets skip asking Utila about an asset an earlier page registered — a round trip that can only return what is already stored, and that fails outright on a token Utila does not carry.

      Names in, names out, so the caller never has to strip the prefix (§ 4.12).

      Parameters

      • __namedParameters: { names: string[] }

      Returns Promise<Set<string>>

    • Every address a wallet has moved funds through, as the vault's stored transactions name it, first seen first: networkId alone says its chain. An address that never transacted holds nothing and is absent.

      vaultId and walletId are Utila's own ids.

      Parameters

      • __namedParameters: { vaultId: string; walletId: string }

      Returns Promise<{ address: string; networkId: string | null }[]>

    • The ids of the vault's wallets its stored transactions name on a transfer, in id order, after after and at most limit of them. A wallet that never moved funds is absent. vaultId is Utila's own id.

      Parameters

      • __namedParameters: { after: string | null; limit: number; vaultId: string }

      Returns Promise<string[]>

    Settings
    Member Visibility

    On This Page
    Constructors
    Properties
    Methods