tapimo 0.0.2 → 0.2.0

package/dist/handlers/internal/executionError.js

@@ -0,0 +1,186 @@
+import { decodeErrorResult } from 'viem';
+import { Abis } from 'viem/tempo';
+/** Human-readable messages keyed by ABI error name. */
+export const messages = {
+    AddressAlreadyHasValidator: 'This address already has a validator.',
+    AddressNotReserved: 'Address is not reserved.',
+    AddressReserved: 'Address is reserved.',
+    AlreadyInitialized: 'Already initialized.',
+    AmountExceedsDeposit: 'Amount exceeds deposit.',
+    AmountNotIncreasing: 'Amount is not increasing.',
+    BelowMinimumOrderSize: 'Order size is below the minimum allowed ({0}).',
+    CallNotAllowed: 'This call is not allowed.',
+    CannotChangeWithinBlock: 'Cannot change within the same block.',
+    CaptureAmountInvalid: 'Capture amount is invalid.',
+    ChannelAlreadyExists: 'Channel already exists.',
+    ChannelNotFound: 'Channel not found.',
+    CloseNotReady: 'Channel is not ready to close.',
+    ContractPaused: 'Contract is paused.',
+    DelegateCallNotAllowed: 'Delegate call is not allowed.',
+    DepositOverflow: 'Deposit overflow.',
+    DivisionByZero: 'Division by zero.',
+    EmptyV1ValidatorSet: 'Validator set is empty.',
+    ExpiringNonceHashNotSet: 'Expiring nonce hash is not set.',
+    ExpiringNonceReplay: 'Expiring nonce has already been used.',
+    ExpiringNonceSetFull: 'Expiring nonce set is full.',
+    ExpiryInPast: 'Expiry is in the past.',
+    IdenticalAddresses: 'Addresses must be different.',
+    IdenticalTokens: 'Cannot swap a token for itself — input and output tokens must be different.',
+    IncompatiblePolicyType: 'Incompatible policy type.',
+    IngressAlreadyExists: 'Ingress "{0}" already exists.',
+    InsufficientAllowance: 'Insufficient allowance.',
+    InsufficientBalance: 'Insufficient balance. Required: {1}, available: {0}.',
+    InsufficientFeeTokenBalance: 'Insufficient fee token balance.',
+    InsufficientLiquidity: 'Not enough liquidity in the order book to fill this trade.',
+    InsufficientOutput: 'The output amount is below the slippage minimum — try increasing slippage tolerance.',
+    InsufficientReserves: 'Insufficient reserves.',
+    InvalidAmount: 'Invalid amount.',
+    InvalidBaseToken: 'This token is not a valid base token for the requested pair.',
+    InvalidCallScope: 'Invalid call scope.',
+    InvalidClaimAddress: 'Invalid claim address.',
+    InvalidCurrency: 'Invalid currency.',
+    InvalidExpiringNonceExpiry: 'Invalid expiring nonce expiry.',
+    InvalidFlipTick: 'The flip-order price tick is invalid.',
+    InvalidFormat: 'Invalid format.',
+    InvalidKeyAuthorizationWitness: 'Invalid key authorization witness.',
+    InvalidKeyId: 'Invalid key ID.',
+    InvalidLogoURI: 'Invalid logo URI.',
+    InvalidMasterAddress: 'Invalid master address.',
+    InvalidMigrationIndex: 'Invalid migration index.',
+    InvalidMode: 'Invalid mode.',
+    InvalidNonceKey: 'Invalid nonce key.',
+    InvalidOwner: 'Invalid owner.',
+    InvalidPayee: 'Invalid payee.',
+    InvalidPayload: 'Invalid payload.',
+    InvalidPolicyType: 'Invalid policy type.',
+    InvalidPublicKey: 'Invalid public key.',
+    InvalidQuoteToken: 'Invalid quote token.',
+    InvalidReceipt: 'Invalid receipt.',
+    InvalidReceivePolicyType: 'Invalid receive policy type.',
+    InvalidRecipient: 'Invalid recipient.',
+    InvalidRecoveryAuthority: 'Invalid recovery authority.',
+    InvalidSignature: 'Invalid signature.',
+    InvalidSignatureFormat: 'Invalid signature format.',
+    InvalidSignatureType: 'Invalid signature type.',
+    InvalidSpendingLimit: 'Invalid spending limit.',
+    InvalidSupplyCap: 'Invalid supply cap.',
+    InvalidSwapCalculation: 'Invalid swap calculation.',
+    InvalidTick: 'The price tick is invalid.',
+    InvalidToken: 'This token is not supported on the exchange.',
+    InvalidTransferPolicyId: 'Invalid transfer policy.',
+    InvalidValidatorAddress: 'Invalid validator address.',
+    KeyAlreadyExists: 'Key already exists.',
+    KeyAlreadyRevoked: 'Key has already been revoked.',
+    KeyAuthorizationWitnessAlreadyBurned: 'Key authorization witness has already been burned.',
+    KeyExpired: 'Key has expired.',
+    KeyNotFound: 'Key not found.',
+    LegacyAuthorizeKeySelectorChanged: 'Legacy authorize key selector changed to {0}.',
+    LogoURITooLong: 'Logo URI is too long.',
+    MasterIdCollision: 'Master ID collision with {0}.',
+    MaxInputExceeded: 'The required input exceeds the slippage maximum — try increasing slippage tolerance.',
+    MigrationNotComplete: 'Migration is not complete.',
+    NoOptedInSupply: 'No opted-in supply.',
+    NonceOverflow: 'Nonce overflow.',
+    NotHostPort: '"{1}" is not a valid host:port for {0}.',
+    NotInitialized: 'Not initialized.',
+    NotIp: '"{0}" is not a valid IP address.',
+    NotIpPort: '"{1}" is not a valid IP:port for {0}.',
+    NotPayeeOrOperator: 'Not payee or operator.',
+    NotPayer: 'Not payer.',
+    OrderDoesNotExist: 'No order exists with the given ID.',
+    OrderNotStale: 'This order is not yet eligible for stale-cleanup.',
+    PairAlreadyExists: 'A trading pair for these tokens has already been created.',
+    PairDoesNotExist: 'No trading pair exists for these tokens.',
+    PermitExpired: 'Permit has expired.',
+    PolicyForbids: 'Forbidden by policy.',
+    PolicyNotFound: 'Policy not found.',
+    PolicyNotSimple: 'Policy is not a simple policy.',
+    ProofOfWorkFailed: 'Proof of work failed.',
+    ProtectedAddress: 'Address is protected.',
+    ProtocolNonceNotSupported: 'Protocol nonce is not supported.',
+    PublicKeyAlreadyExists: 'Public key already exists.',
+    SignatureTypeMismatch: 'Signature type mismatch. Expected {0}, got {1}.',
+    SpendingLimitExceeded: 'Spending limit exceeded.',
+    SupplyCapExceeded: 'Supply cap exceeded.',
+    TickOutOfBounds: 'Price tick {0} is outside the allowed range.',
+    TokenAlreadyExists: 'Token {0} already exists.',
+    Unauthorized: 'Unauthorized.',
+    UnauthorizedCaller: 'Unauthorized caller.',
+    UnauthorizedClaimer: 'Unauthorized claimer.',
+    Uninitialized: 'Uninitialized.',
+    ValidatorAlreadyDeactivated: 'Validator is already deactivated.',
+    ValidatorAlreadyExists: 'Validator already exists.',
+    ValidatorNotFound: 'Validator not found.',
+    VirtualAddressNotAllowed: 'Virtual address is not allowed.',
+    VirtualAddressUnregistered: 'Virtual address is not registered.',
+    ZeroDeposit: 'Deposit cannot be zero.',
+    ZeroPublicKey: 'Public key cannot be zero.',
+};
+/** Interpolate `{0}`, `{1}`, … placeholders with args. */
+function interpolate(template, args) {
+    if (!args)
+        return template;
+    return template.replace(/\{(\d+)\}/g, (_, i) => {
+        const v = args[Number(i)];
+        return v === undefined ? `{${i}}` : String(v);
+    });
+}
+/** Parse a viem error into a structured execution error. */
+export function parse(error) {
+    const raw = error.details ??
+        error.shortMessage ??
+        error.message;
+    const data = extractRevertData(error);
+    if (data) {
+        try {
+            const decoded = decodeErrorResult({ abi: Abis.abis, data });
+            const template = messages[decoded.errorName];
+            return {
+                ...decoded,
+                data,
+                message: template
+                    ? interpolate(template, decoded.args)
+                    : raw.replace(/^execution reverted:\s*/i, ''),
+            };
+        }
+        catch { }
+    }
+    // Fallback: extract error name from human-readable revert message.
+    const nameMatch = /:\s*(\w+)\(\w+/.exec(raw);
+    const errorName = nameMatch?.[1];
+    if (errorName && errorName in messages)
+        return { errorName: 'unknown', message: messages[errorName] };
+    return {
+        errorName: 'unknown',
+        message: raw.replace(/^execution reverted:\s*/i, ''),
+    };
+}
+/** Serializes an ExecutionError for RPC transport (bigints/numbers → hex). */
+export function serialize(preimage) {
+    if (preimage.errorName === 'unknown')
+        return { errorName: 'unknown', message: preimage.message };
+    return {
+        errorName: preimage.errorName,
+        abiItem: preimage.abiItem,
+        message: preimage.message,
+        data: preimage.data,
+    };
+}
+function extractRevertData(error) {
+    if (!error || typeof error !== 'object')
+        return null;
+    const e = error;
+    if (typeof e['data'] === 'string' && e['data'].startsWith('0x'))
+        return e['data'];
+    if (e['cause'])
+        return extractRevertData(e['cause']);
+    if (e['error'])
+        return extractRevertData(e['error']);
+    if (typeof e['walk'] === 'function') {
+        const inner = e.walk((e) => typeof e['data'] === 'string');
+        if (inner)
+            return extractRevertData(inner);
+    }
+    return null;
+}
+//# sourceMappingURL=executionError.js.map

package/dist/handlers/internal/executionError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executionError.js","sourceRoot":"","sources":["../../../src/handlers/internal/executionError.ts"],"names":[],"mappings":"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"}

package/dist/handlers/internal/multisig.d.ts

@@ -0,0 +1,233 @@
+import { Hex } from 'ox';
+import { MultisigConfig } from 'ox/tempo';
+import type { Address, Client } from 'viem';
+import type { LocalAccount } from 'viem/accounts';
+import * as core_Store from '../../internal/Store.js';
+import * as Sponsorship from './sponsorship.js';
+/** Default submission-claim TTL in milliseconds. */
+export declare const defaultClaimTtl = 30000;
+/** Returns whether a raw transaction carries a native multisig signature. */
+export declare function isMultisigTransaction(serialized: Hex.Hex): boolean;
+/** Handles a native multisig raw transaction submission. */
+export declare function handleRawTransaction(options: handleRawTransaction.Options): Promise<handleRawTransaction.ReturnType>;
+export declare namespace handleRawTransaction {
+    /** Options for handling a raw multisig transaction submission. */
+    type Options = collect.Options;
+    /** Raw transaction handler return value. */
+    type ReturnType = Hex.Hex | unknown;
+}
+declare function collect(options: collect.Options): Promise<collect.ReturnType>;
+/** Resolves a multisig operation id for standard transaction lookup methods. */
+export declare function handleGetTransaction(options: handleGetTransaction.Options): Promise<handleGetTransaction.ReturnType>;
+export declare namespace handleGetTransaction {
+    /** Options for resolving a multisig operation id through transaction lookup methods. */
+    type Options = {
+        /** Client resolver keyed by transaction `chainId`. */
+        getClient: (chainId?: number) => Client;
+        /** Standard transaction lookup method to handle. */
+        method: 'eth_getTransactionByHash' | 'eth_getTransactionReceipt';
+        /** Incoming JSON-RPC request. */
+        request: {
+            params?: readonly unknown[] | undefined;
+        };
+        /** Pending multisig operation store. */
+        store: Store;
+    };
+    /** Transaction lookup result wrapper. */
+    type ReturnType = {
+        result: unknown;
+    } | undefined;
+}
+declare namespace collect {
+    type Options = {
+        /** Submission claim TTL in milliseconds. @default 30000 */
+        claimTtl?: number | undefined;
+        /** How to broadcast once quorum is met. @default 'sync' */
+        finalize?: 'submitted' | 'sync' | undefined;
+        /** Client resolver keyed by transaction `chainId`. */
+        getClient: (chainId?: number) => Client;
+        /** Raw transaction method to handle. */
+        method: 'eth_sendRawTransaction' | 'eth_sendRawTransactionSync';
+        /** Incoming JSON-RPC request. */
+        request: {
+            params?: readonly unknown[] | undefined;
+        };
+        /** Resolves the genesis multisig config for quorum checks. */
+        resolveConfig?: ResolveConfig | undefined;
+        /** Optional fee payer used to sponsor finalized multisig transactions. */
+        sponsor?: Sponsor | undefined;
+        /** Pending multisig operation store. */
+        store: Store;
+    };
+    type ReturnType = {
+        /** Raw broadcast result once quorum is met and this caller claimed submission. */
+        broadcastResult?: unknown;
+        /** Structured operation claim status. */
+        status: ClaimSubmissionResult | {
+            operation: Operation;
+            status: 'claimed';
+        };
+    };
+}
+/** Returns a stored native multisig operation status. */
+export declare function getStatus(options: getStatus.Options): Promise<Status | null>;
+export declare namespace getStatus {
+    /** Options for reading one multisig operation status. */
+    type Options = {
+        /** Operation id returned by a pending multisig submission. */
+        id: Hex.Hex;
+        /** Resolves the genesis multisig config for quorum status. */
+        resolveConfig?: ResolveConfig | undefined;
+        /** Pending multisig operation store. */
+        store: Store;
+    };
+}
+/** Returns pending native multisig operation statuses for an account. */
+export declare function listStatuses(options: listStatuses.Options): Promise<readonly Status[]>;
+export declare namespace listStatuses {
+    /** Options for listing multisig operation statuses. */
+    type Options = {
+        /** Native multisig account address. */
+        account: Address;
+        /** Resolves the genesis multisig config for quorum status. */
+        resolveConfig?: ResolveConfig | undefined;
+        /** Pending multisig operation store. */
+        store: Store;
+    };
+}
+/**
+ * Creates a multisig operation store backed by a Tempo API state store
+ * (`Store.memory()`, a static-name Durable Object store, …).
+ *
+ * Approval merges and submission claims go through `Store.update`, so the
+ * backing store needs the atomic `swap` compare-and-swap to serialize
+ * concurrent writers (the get + put fallback is dev-only). It must also be
+ * enumerable — `listPendingByAddress` scans a key prefix — so sharded Durable
+ * Object stores and caches do not qualify.
+ */
+export declare function fromStore(state: core_Store.State): Store;
+/** Creates an in-memory multisig operation store for development and tests only. */
+export declare function memoryStore(): Store;
+/** Native multisig relay options. */
+export type Options = {
+    /** Submission claim TTL in milliseconds. @default 30000 */
+    claimTtl?: number | undefined;
+    /** How to broadcast once quorum is met. @default 'sync' */
+    finalize?: 'submitted' | 'sync' | undefined;
+    /** Resolves the genesis multisig config for quorum checks. */
+    resolveConfig?: ResolveConfig | undefined;
+    /**
+     * State store holding pending multisig operations. Needs the store's atomic
+     * `swap` for correctness (approval merges and submission claims serialize
+     * through it) and must be enumerable, so sharded Durable Object stores and
+     * caches do not qualify.
+     */
+    store: core_Store.State;
+};
+/** Resolves the genesis multisig config for quorum checks. */
+export type ResolveConfig = (request: {
+    /** Native multisig account address. */
+    account: Address;
+    /** Transaction chain id. */
+    chainId: number;
+    /** Bootstrap config carried by the transaction, when present. */
+    init?: MultisigConfig.Config | undefined;
+}) => MultisigConfig.Config | Promise<MultisigConfig.Config | undefined> | undefined;
+/** Optional fee payer used to sponsor finalized multisig transactions. */
+export type Sponsor = {
+    /** Account used as the fee payer. */
+    account: LocalAccount;
+    /** Fee token to set before fee payer signing. */
+    feeToken?: Address | undefined;
+    /** Called once the fee payer has signed, before any broadcast. */
+    onSponsored?: Sponsorship.handleRawTransaction.Options['onSponsored'];
+    /** Resolves the default fee token for raw sponsorship. */
+    resolveFeeToken?: ((chainId: number) => Address | Promise<Address | undefined> | undefined) | undefined;
+    /** Optional sponsorship approval callback. */
+    validate?: Sponsorship.handleRawTransaction.Options['validate'];
+};
+/** Storage for native multisig operation approvals and submission claims. */
+export type Store = {
+    /** Atomically claims submission for a quorum-ready operation. Only a `claimed` result may broadcast. */
+    claimSubmission: (operation: Operation, options: claimSubmission.Options) => Promise<ClaimSubmissionResult>;
+    /** Reads a stored operation. */
+    get: (id: Hex.Hex) => Promise<Operation | undefined>;
+    /** Lists non-submitted operations for a native multisig account address. */
+    listPendingByAddress: (address: Address) => Promise<readonly Operation[]>;
+    /** Saves a pending operation, preserving already-stored approvals. */
+    savePending: (operation: Operation) => Promise<Operation>;
+    /** Marks a claimed operation submitted with its real transaction hash. */
+    setSubmitted: (id: Hex.Hex, submittedHash: Hex.Hex) => Promise<Operation>;
+};
+/** `Store.claimSubmission` types. */
+export declare namespace claimSubmission {
+    /** Options for claiming submission. */
+    type Options = {
+        /** Claim TTL in milliseconds. */
+        ttl: number;
+    };
+}
+/** Result of atomically claiming a multisig operation for submission. */
+export type ClaimSubmissionResult = {
+    /** Operation this caller may broadcast. */
+    operation: Operation;
+    /** Claim status. */
+    status: 'claimed';
+} | {
+    /** Current stored operation. */
+    operation: Operation;
+    /** Current non-claimed status. */
+    status: 'pending' | 'submitting' | 'submitted';
+};
+/** Stored native multisig operation. */
+export type Operation = {
+    /** Native multisig account address. */
+    account: Address;
+    /** Transaction chain id. */
+    chainId: number;
+    /** Submission claim expiry timestamp in milliseconds. */
+    claimExpiresAt?: number | undefined;
+    /** Resolved genesis config used for approval checks. */
+    config?: MultisigConfig.Config | undefined;
+    /** Creation timestamp in milliseconds. */
+    createdAt: number;
+    /** Deterministic operation id. */
+    id: Hex.Hex;
+    /** Whether the finalized transaction must carry the genesis init config. */
+    init?: boolean | undefined;
+    /** Genesis init config to attach when finalizing a bootstrap transaction. */
+    initConfig?: MultisigConfig.Config | undefined;
+    /** Unsigned Tempo transaction sign payload. */
+    payload: Hex.Hex;
+    /** Collected owner approval signatures. */
+    signatures: readonly Hex.Hex[];
+    /** Operation state. */
+    status: 'pending' | 'submitting' | 'submitted';
+    /** Transaction hash once submitted. */
+    submittedHash?: Hex.Hex | undefined;
+    /** Last submitted serialized transaction carrying this operation. */
+    transaction: Hex.Hex;
+    /** Last update timestamp in milliseconds. */
+    updatedAt: number;
+};
+/** Native multisig operation status. */
+export type Status = {
+    /** Native multisig account address. */
+    account: Address;
+    /** Transaction chain id. */
+    chainId: number;
+    /** Deterministic operation id. */
+    id: Hex.Hex;
+    /** Number of collected owner approvals. */
+    signatures: number;
+    /** Operation state. */
+    status: Operation['status'];
+    /** Submitted transaction hash. */
+    submittedHash?: Hex.Hex | undefined;
+    /** Required owner weight. */
+    threshold?: number | undefined;
+    /** Collected owner weight. */
+    weight?: number | undefined;
+};
+export {};
+//# sourceMappingURL=multisig.d.ts.map

package/dist/handlers/internal/multisig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multisig.d.ts","sourceRoot":"","sources":["../../../src/handlers/internal/multisig.ts"],"names":[],"mappings":"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"}