tapimo 0.15.1 → 0.18.1

package/dist/internal/routes/SolanaTransferSettlement.js

@@ -0,0 +1,220 @@
+import { Hash, Hex } from 'ox';
+import * as Value from '../Value.js';
+import * as SolanaTransferSubsidy from './SolanaTransferSubsidy.js';
+import * as Transfer from './Transfer.js';
+/** Advances a persisted Solana subsidy through signing, broadcast, and finality. */
+export async function settle(options) {
+    let current = options.current;
+    const existing = SolanaTransferSubsidy.readSigned(current.providerState?.['transferSubsidy']);
+    const prepared = SolanaTransferSubsidy.readPrepared(current.providerState?.['solanaTransferSubsidyPrepared']);
+    const terms = {
+        account: existing?.account ?? prepared?.account ?? current.subsidyAccount ?? '',
+        amount: options.deficit,
+        chainId: options.destinationChain.id,
+        recipient: current.snapshot.recipient,
+        token: current.snapshot.destinationToken.address,
+    };
+    if ((existing && !SolanaTransferSubsidy.matchesTerms(existing, terms)) ||
+        (prepared && !SolanaTransferSubsidy.matchesTerms(prepared, terms))) {
+        options.recordSubsidy('evidence_conflict');
+        return {
+            reason: {
+                code: 'subsidy_failed',
+                message: 'Destination subsidy evidence conflicts with the verified delivery.',
+            },
+            record: current,
+            type: 'action-required',
+        };
+    }
+    const account = existing?.account ?? prepared?.account ?? current.subsidyAccount;
+    const settler = options.settlers?.find((entry) => entry.account === account);
+    if (!settler) {
+        options.recordSubsidy('unavailable');
+        return {
+            reason: {
+                code: 'subsidy_failed',
+                message: 'Destination subsidy settlement is unavailable.',
+            },
+            record: current,
+            type: 'action-required',
+        };
+    }
+    const commitment = current.subsidyCommitmentAmount;
+    if (!existing && !prepared && (!commitment || options.deficit > BigInt(commitment.baseUnits))) {
+        options.recordSubsidy('routes_subsidy_limit_exceeded');
+        return {
+            reason: {
+                code: 'routes_subsidy_limit_exceeded',
+                message: 'The required destination subsidy exceeds its approved commitment.',
+            },
+            record: current,
+            type: 'action-required',
+        };
+    }
+    const recipient = current.snapshot.recipient;
+    const token = current.snapshot.destinationToken.address;
+    const subsidyAmount = Value.tokenAmount({
+        baseUnits: options.deficit,
+        currency: current.snapshot.destinationToken.currency,
+        decimals: current.snapshot.destinationToken.decimals,
+    });
+    let signed = existing;
+    if (!signed) {
+        const result = await Transfer.prepareSolanaSubsidy(options.db, {
+            account: settler.account,
+            chainId: options.destinationChain.id,
+            expiring: (prepared) => settler.expiring({ chain: options.destinationChain, prepared }),
+            id: current.id,
+            orgId: current.orgId,
+            prepare: ({ reservations }) => settler.prepare({
+                amount: options.deficit,
+                chain: options.destinationChain,
+                recipient,
+                reservations,
+                token,
+            }),
+            subsidyAmount,
+            tokenAddress: token,
+        }).catch((cause) => {
+            if (cause instanceof SolanaTransferSubsidy.BalanceUnavailableError)
+                return 'balance';
+            if (cause instanceof Transfer.SubsidySignerBlockedError)
+                return 'blocked';
+            throw cause;
+        });
+        if (result === 'balance' || result === 'blocked') {
+            options.recordSubsidy(result === 'balance' ? 'balance_unavailable' : 'signer_blocked');
+            return {
+                reason: {
+                    code: result === 'balance' ? 'subsidy_balance_unavailable' : 'subsidy_failed',
+                    message: result === 'balance'
+                        ? 'Tempo lacks enough destination token inventory or native gas.'
+                        : 'Destination subsidy settlement requires operator recovery.',
+                },
+                record: current,
+                type: 'action-required',
+            };
+        }
+        if (result.type === 'not_found' || result.type === 'invalid' || result.type === 'pending')
+            return { type: 'pending' };
+        current = result.record;
+        if ('references' in result && result.references && options.dispatchTransferUpdates)
+            await options.dispatchTransferUpdates(result.references);
+        if (result.type === 'signed' || result.type === 'shared') {
+            signed = result.signed;
+            if (result.type === 'shared')
+                options.recordSubsidy('shared');
+        }
+        else {
+            options.recordSubsidy('prepared');
+            if (await settler.expiring({ chain: options.destinationChain, prepared: result.prepared }))
+                return { type: 'pending' };
+            // A refreshed blockhash changes the request, so Horcrux must use a new replay key.
+            const signature = await settler.sign({
+                idempotencyKey: `${current.id}:${Hash.sha256(Hex.fromBytes(Buffer.from(result.prepared.request.transaction, 'base64')))}`,
+                prepared: result.prepared,
+            });
+            if (await settler.expiring({ chain: options.destinationChain, prepared: result.prepared }))
+                return { type: 'pending' };
+            const persisted = await Transfer.signSolanaSubsidy(options.db, {
+                id: current.id,
+                signed: signature,
+            });
+            if (persisted.type === 'not_found' || persisted.type === 'invalid')
+                return { type: 'pending' };
+            signed = persisted.signed;
+            current = persisted.record;
+            if ('references' in persisted && options.dispatchTransferUpdates)
+                await options.dispatchTransferUpdates(persisted.references);
+            options.recordSubsidy(persisted.type === 'shared' ? 'shared' : 'signed');
+        }
+    }
+    if (typeof current.providerState?.['transferSubsidyOwnerId'] === 'string' &&
+        current.providerState['transferSubsidyOwnerId'] !== current.id) {
+        const result = await Transfer.syncSharedSolanaSubsidy(options.db, {
+            id: current.id,
+            orgId: current.orgId,
+            signed,
+        });
+        if (result.type === 'not_found' || result.type === 'pending')
+            return { type: 'pending' };
+        if (result.type === 'synchronized') {
+            current = result.record;
+            signed = result.signed;
+            options.recordSubsidy('shared');
+            if (options.dispatchTransferUpdates)
+                await options.dispatchTransferUpdates(result.references);
+        }
+    }
+    const status = await settler.status({
+        chain: options.destinationChain,
+        recipient,
+        signed,
+        token,
+    });
+    if (status === 'expired') {
+        const result = await Transfer.recoverExpiredSolanaSubsidy(options.db, {
+            id: current.id,
+            orgId: current.orgId,
+            signed,
+        });
+        if (result.type === 'recovered') {
+            options.recordSubsidy('expired_recovered');
+            if (options.dispatchTransferUpdates)
+                await options.dispatchTransferUpdates(result.references);
+        }
+        return { type: 'pending' };
+    }
+    if (status === 'ambiguous') {
+        options.recordSubsidy('expiry_ambiguous');
+        return {
+            reason: {
+                code: 'manual_recovery_required',
+                message: 'The Solana subsidy transaction could not be verified after expiry.',
+            },
+            record: current,
+            type: 'action-required',
+        };
+    }
+    if (status === 'reverted') {
+        options.recordSubsidy('reverted');
+        return {
+            reason: {
+                code: 'subsidy_failed',
+                message: 'The destination subsidy transaction reverted.',
+            },
+            record: current,
+            state: {
+                subsidyAmount: Value.tokenAmount({
+                    baseUnits: 0n,
+                    currency: current.snapshot.destinationToken.currency,
+                    decimals: current.snapshot.destinationToken.decimals,
+                }),
+            },
+            type: 'action-required',
+        };
+    }
+    if (status === 'pending') {
+        const rejected = await settler.broadcast({ chain: options.destinationChain, signed }).then(() => false, (cause) => {
+            if (SolanaTransferSubsidy.isPermanentBroadcastError(cause))
+                return true;
+            throw cause;
+        });
+        if (rejected) {
+            options.recordSubsidy('broadcast_rejected');
+            return {
+                reason: {
+                    code: 'subsidy_failed',
+                    message: 'The Solana subsidy transaction was rejected.',
+                },
+                record: current,
+                type: 'action-required',
+            };
+        }
+        options.recordSubsidy('broadcast');
+        return { type: 'pending' };
+    }
+    options.recordSubsidy('completed');
+    return { amount: options.deficit, hash: signed.hash, record: current, type: 'success' };
+}
+//# sourceMappingURL=SolanaTransferSettlement.js.map

package/dist/internal/routes/SolanaTransferSettlement.js.map

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

package/dist/internal/routes/SolanaTransferSubsidy.d.ts

@@ -0,0 +1,172 @@
+import type * as Chain from './Chain.js';
+/** An immutable Solana transaction prepared before requesting a Horcrux signature. */
+export type Prepared = {
+    /** Horcrux wallet public key. */
+    account: string;
+    /** Destination token quantity in base units. */
+    amount: string;
+    /** Destination chain identifier. */
+    chainId: string;
+    /** Derived recipient USDC token account. */
+    destination: string;
+    /** Last block height at which Solana accepts the transaction. */
+    lastValidBlockHeight: number;
+    /** Native SOL fee reserved in lamports. */
+    nativeAmount: string;
+    /** Finalized slot that supplied the transaction blockhash. */
+    originSlot: number;
+    /** Recipient wallet public key. */
+    recipient: string;
+    /** Exact body sent to Horcrux on signing retries. */
+    request: {
+        network: 'solana:mainnet-beta';
+        transaction: string;
+    };
+    /** Derived subsidy wallet USDC token account. */
+    source: string;
+    /** Destination token mint. */
+    token: string;
+};
+/** A Horcrux-signed transaction persisted before broadcast. */
+export type Signed = Prepared & {
+    /** First Solana signature, used as the transaction identifier. */
+    hash: string;
+    /** Canonical signed transaction in standard base64. */
+    transaction: string;
+};
+/** Read-only Solana destination subsidy inventory checker. */
+export type Inventory = {
+    /** Horcrux wallet public key. */
+    account: string;
+    /** Checks USDC and SOL capacity including unsettled commitments. */
+    check(options: create.CheckOptions): Promise<{
+        nativeAmount: string;
+    }>;
+    /** Operational maximum destination subsidy. */
+    policy: {
+        maxAmount: string;
+    };
+};
+/** Prepares, signs, broadcasts, and verifies Solana destination subsidies. */
+export type Settler = Inventory & {
+    /** Broadcasts the persisted signed transaction. */
+    broadcast(options: {
+        chain: Chain.Chain;
+        signed: Signed;
+    }): Promise<void>;
+    /** Checks whether a prepared blockhash is too close to expiry to sign safely. */
+    expiring(options: {
+        chain: Chain.Chain;
+        prepared: Prepared;
+    }): Promise<boolean>;
+    /** Constructs an unsigned transfer without contacting Horcrux. */
+    prepare(options: create.CheckOptions): Promise<Prepared>;
+    /** Signs an immutable request through Horcrux. */
+    sign(options: {
+        idempotencyKey: string;
+        prepared: Prepared;
+    }): Promise<Signed>;
+    /** Reads finalized execution for the exact signed transaction. */
+    status(options: create.StatusOptions): Promise<'ambiguous' | 'expired' | 'pending' | 'reverted' | 'success'>;
+};
+/** Validates prepared subsidy state restored from durable storage. */
+export declare function readPrepared(value: unknown): Prepared | undefined;
+/** Validates signed subsidy state restored from durable storage. */
+export declare function readSigned(value: unknown): Signed | undefined;
+/** Checks persisted transaction terms against freshly verified delivery. */
+export declare function matchesTerms(prepared: Prepared, options: matchesTerms.Options): boolean;
+export declare namespace matchesTerms {
+    /** Exact terms required before a subsidy is signed or broadcast. */
+    type Options = {
+        account: string;
+        amount: bigint;
+        chainId: string;
+        recipient: string;
+        token: string;
+    };
+}
+/** Creates a Solana inventory checker and Horcrux signer for one wallet. */
+export declare function create(options: create.Options): Settler;
+export declare namespace create {
+    /** Horcrux connection and Solana RPC dependencies. */
+    type Options = {
+        account: string;
+        fetch: typeof globalThis.fetch;
+        horcrux: {
+            auth: {
+                type: 'none';
+            } | {
+                clientId: string;
+                clientSecret: string;
+                type: 'cloudflare-access';
+            };
+            url: string;
+        };
+        policy: {
+            maxAmount: string;
+        };
+        walletId: string;
+    };
+    /** Creation-time inventory request. */
+    type CheckOptions = {
+        amount: bigint;
+        chain: Chain.Chain;
+        recipient: string;
+        reservations: {
+            nativeAmount: bigint;
+            tokenAmount: bigint;
+        };
+        token: string;
+    };
+    /** Finalized receipt query and expected delivery. */
+    type StatusOptions = {
+        chain: Chain.Chain;
+        recipient: string;
+        signed: Signed;
+        token: string;
+    };
+}
+/** Checks one finalized block against the signed transaction and the preceding block. */
+export declare function inspectFinalizedBlock(options: inspectFinalizedBlock.Options): {
+    type: 'ambiguous';
+} | {
+    blockhash: string;
+    blockHeight: number;
+    type: 'absent' | 'expired' | 'found';
+};
+export declare namespace inspectFinalizedBlock {
+    /** Finalized block and its expected place in a continuous chain. */
+    type Options = {
+        block: unknown;
+        lastValidBlockHeight: number;
+        originSlot: number;
+        previousBlockhash: string | undefined;
+        previousHeight: number | undefined;
+        previousSlot: number | undefined;
+        signature: string;
+        slot: number;
+    };
+}
+/** Returns whether replaying the same signed transaction cannot succeed. */
+export declare function isPermanentBroadcastError(cause: unknown): boolean;
+/** The subsidy wallet lacks USDC or SOL inventory. */
+export declare class BalanceUnavailableError extends Error {
+    name: string;
+}
+/** Solana subsidy configuration or persisted terms are invalid. */
+export declare class ConfigurationError extends Error {
+    name: string;
+}
+/** Horcrux failed to return the expected Solana signature. */
+export declare class SigningError extends Error {
+    name: string;
+}
+/** Solana rejected a signed subsidy transaction. */
+export declare class BroadcastError extends Error {
+    name: string;
+}
+/** Solana RPC could not provide reliable inventory or fee data. */
+export declare class UpstreamError extends Error {
+    name: string;
+}
+//# sourceMappingURL=SolanaTransferSubsidy.d.ts.map

package/dist/internal/routes/SolanaTransferSubsidy.d.ts.map

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