catapultar 0.1.0

package/dist/catapultar/catapultar.js

@@ -0,0 +1,200 @@
+import { hashTypedData } from "viem";
+import { random } from "../utils/helpers.js";
+import { AccountPublicKeyType, CallsTyped, ExecutionMode, } from "../types/types.js";
+import { CatapultarAccount } from "./account.js";
+import { BaseTransaction } from "../transaction/transaction.js";
+/**
+ * A Catapultar transaction wrapper. Is intended to be used to convert a list of calls into a single Catapultar batch.
+ * @dev The class is intended to be used through modifiers, meaning each property should be set iteratively on the object:
+ * const tx = new CatapultarTx(options).setMode(ExecutionMode.RaiseRevert).setNonce(12n).addCalls(...[]).sign(() => ...).asParameters();
+ * To batch batches, multiple sub CatapultarTx can be created and then converted into calls like:
+ * calls.push(new CatapultarTx(options).addCalls(...[]).asCall());
+ * new CatapultarTx(options).addCalls(...calls).sign(() => ...).asParameters();
+ */
+export class CatapultarTx extends BaseTransaction {
+    /**
+     * Create a new Catapultar transaction batch.
+     */
+    constructor(options) {
+        super(options);
+        // TODO: If given an object, assign object instead of recreating account.
+        this.account = new CatapultarAccount(options.account);
+    }
+    // --- Export the transaction for saving --- //
+    /**
+     * @returns Constructor parameters for a new (identical) CatapultarTx
+     */
+    export() {
+        return {
+            account: {
+                address: this.account.address,
+                chainId: this.account.chainId,
+                pubkey: this.account.pubkey,
+                name: this.account.name,
+                version: this.account.version,
+            },
+            mode: this.mode,
+            nonce: this.nonce,
+            signature: this.signature,
+            calls: this.calls,
+        };
+    }
+    /**
+     * Sets a signature along with its type. If non-ecdsa signatures are being set, this provides additional aids with encoding
+     */
+    setSignature(signature) {
+        this.signature = this.account.parseSignature(signature);
+    }
+    /**
+     * Sign the transaction using a Ethers compatible signer function.
+     * @dev The callback function will be called with a typeset compatible with ether.Signer._signTypedData.
+     * An alternative way to sign this function is to set it manually as .signature.
+     */
+    async sign(callback, options) {
+        const signerData = this.getSignerData(options);
+        this.signature = this.account.parseSignature(await callback(signerData));
+        return this;
+    }
+    // --- Validation --- //
+    async hasValidSignature(options) {
+        const { noSignatureIsValid = false } = options ?? {};
+        if (this.signature === undefined)
+            return noSignatureIsValid;
+        return this.account.isSignatureValid({
+            signature: this.signature,
+            hash: this.getTypeHashDigest({ ignoreNoCalls: true }),
+        });
+    }
+    async validateSignature(options) {
+        if (!(await this.hasValidSignature(options)))
+            throw new Error(`Invalid Signer`);
+        return this;
+    }
+    async validateUsingProvider() {
+        await this.account.validateNonce({ nonce: this.nonce });
+        await this.account.validateOwner();
+        return this;
+    }
+    // --- Order Creation --- //
+    /**
+     * Returns an Ethers compatible typed dict.
+     * @param options.ignoreNoCalls Do not throw an error if no calls have been configured. Default: false
+     */
+    getSignerData(options) {
+        const { ignoreNoCalls = false } = options ?? {};
+        if (this.nonce === 0n)
+            throw new Error(`Nonce 0 is not allowed. It cannot be differentiated from an invalid nonce.`);
+        if (!this.nonce)
+            throw new Error("Nonce has not been set");
+        if (!this.mode || !this.hasValidMode())
+            throw new Error("Mode has not been set");
+        if (!ignoreNoCalls && this.calls.length === 0)
+            throw new Error("Calls have not been set");
+        return {
+            domain: this.account.getDomainSeparator({
+                chain: !this.hasMultichainMode(),
+            }),
+            types: CallsTyped,
+            primaryType: "Calls",
+            message: {
+                nonce: this.nonce,
+                mode: this.mode,
+                calls: this.calls,
+            },
+        };
+    }
+    getTypeHashDigest(options) {
+        const signerData = this.getSignerData(options);
+        return hashTypedData(signerData);
+    }
+    /**
+     * Returns the signature as a on-chain compatible signature with an indicator byte.
+     * For ECDSA / Smart contracts returns as is.
+     * For P256, pads to 65. Then adds 00.
+     *
+     * @param Signature If provided, will act on the provided signature instead.
+     */
+    asCompatibleSignature(signature) {
+        const sig = signature ?? this.signature;
+        if (!sig)
+            throw new Error("A signature has to be provided");
+        if (this.account.accountPublicKeyType ===
+            AccountPublicKeyType.ECDSAOrSmartContract)
+            return sig;
+        if (this.account.accountPublicKeyType === AccountPublicKeyType.P256 ||
+            this.account.accountPublicKeyType === AccountPublicKeyType.WebAuthnP256) {
+            // If length >= 66, return as is.
+            if (sig.replace("0x", "").length >= 66 * 2)
+                return sig;
+            // Pad end to 65. Then add 00.
+            return `0x${sig.replace("0x", "").padEnd(65 * 2, "0")}00`;
+        }
+        throw new Error(`Unknown key scheme ${this.account.accountPublicKeyType}`);
+    }
+    // --- Convert the transaction object into actionable items --- //
+    /**
+     * @return As a call for further scheduling or manual transaction signing. If used for manual transaction.
+     */
+    async asCall() {
+        // TODO: validation
+        return {
+            ...(await this.asCallData()),
+            to: this.account.address,
+        };
+    }
+}
+/**
+ * This defines a meta transaction composed of several smaller transactions.
+ * Intended usecase: Wrapping multiple transactions (that can later be retried) into a single batch.
+ */
+export class MetaCatapultarTx {
+    constructor(options) {
+        this.calls = [];
+        // TODO: If given an object, assign object instead of recreating account.
+        this.account = new CatapultarAccount(options.account);
+        // Random bytes with rightmost byte empty.
+        const randomNonce = BigInt(random(31)) << 8n;
+        const { mode, nonce, outerNonce = randomNonce, innerNonce = randomNonce + 1n, } = options;
+        // Transaction Definition
+        this.mode = mode;
+        this.nonce = nonce;
+        this.outerNonce = outerNonce;
+        this.innerNonce = innerNonce;
+    }
+    setMode(mode) {
+        this.mode = mode;
+        return this;
+    }
+    addCalls(...calls) {
+        for (const call of calls) {
+            this.calls.push(call);
+        }
+        return this;
+    }
+    checkNonces() {
+        const nonces = this.calls.map((tx) => tx.nonce).filter((n) => !!n);
+        if ([...new Set(nonces)].length != nonces.length)
+            throw new Error(`Duplicate nonces were found: ${nonces}`);
+        return this;
+    }
+    getCallsAsTxs() {
+        return this.calls.map((c, i) => {
+            return new CatapultarTx({
+                account: this.account,
+            })
+                .setMode(c.mode ? c.mode : ExecutionMode.RaiseRevert)
+                .setNonce(c.nonce ? c.nonce : this.innerNonce + BigInt(i))
+                .addCall(...c.calls);
+        });
+    }
+    async asCatapultarTx() {
+        this.checkNonces();
+        return new CatapultarTx({
+            account: this.account,
+        })
+            .setNonce(this.outerNonce)
+            .setMode(this.mode ?? ExecutionMode.SkipRevert)
+            .addCall(...(await Promise.all(this.getCallsAsTxs().map((c) => c.asCall()))));
+    }
+}
+//# sourceMappingURL=catapultar.js.map

package/dist/catapultar/catapultar.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,14 @@
+import type { Factory, MaybeFactory } from "./types/types.js";
+export declare const factories: {
+    readonly "0.1.0": "0x92cEf6f87b4350C9ebA3D73A97b251b41D4AA348";
+};
+export declare const templates: {
+    readonly "0.1.0": "0xD57dEeEaBb0d4Dd2c8421DB036aC2225E54Cd9cC";
+};
+export declare const PUBLIC_DEFAULT_ANVIL_ACCOUNT_0 = "0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80";
+export declare const cat_validator = "0x35C83412d576d624e9aDCa9d5D06559305C097e8";
+export declare const token1 = "0x9fE46736679d2D9a65F0992F2272dE9f3c7fa6e0";
+export declare const token2 = "0xCf7Ed3AccA5a467e9e704C703E8D87F634fB0Fc9";
+export declare const token3 = "0xDc64a140Aa3E981100a9becA4E685f962f0cF6C9";
+export declare function _factory(opt: MaybeFactory): Factory;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE3D,eAAO,MAAM,SAAS;;CAEZ,CAAC;AACX,eAAO,MAAM,SAAS;;CAEZ,CAAC;AAEX,eAAO,MAAM,8BAA8B,uEAC2B,CAAC;AAEvE,eAAO,MAAM,aAAa,+CAA+C,CAAC;AAE1E,eAAO,MAAM,MAAM,+CAA+C,CAAC;AACnE,eAAO,MAAM,MAAM,+CAA+C,CAAC;AACnE,eAAO,MAAM,MAAM,+CAA+C,CAAC;AAEnE,wBAAgB,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAUnD"}

package/dist/config.js

@@ -0,0 +1,24 @@
+export const factories = {
+    "0.1.0": "0x92cEf6f87b4350C9ebA3D73A97b251b41D4AA348",
+};
+export const templates = {
+    "0.1.0": "0xD57dEeEaBb0d4Dd2c8421DB036aC2225E54Cd9cC",
+};
+export const PUBLIC_DEFAULT_ANVIL_ACCOUNT_0 = "0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80";
+export const cat_validator = "0x35C83412d576d624e9aDCa9d5D06559305C097e8";
+export const token1 = "0x9fE46736679d2D9a65F0992F2272dE9f3c7fa6e0";
+export const token2 = "0xCf7Ed3AccA5a467e9e704C703E8D87F634fB0Fc9";
+export const token3 = "0xDc64a140Aa3E981100a9becA4E685f962f0cF6C9";
+export function _factory(opt) {
+    // Ensure that if one key is set, both are set.
+    if ("factory" in opt || "template" in opt) {
+        if ("factory" in opt && "template" in opt)
+            return opt;
+        throw new Error("Factory and template incorrectly set.");
+    }
+    return {
+        factory: factories["0.1.0"],
+        template: templates["0.1.0"],
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,OAAO,EAAE,4CAA4C;CAC7C,CAAC;AACX,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,OAAO,EAAE,4CAA4C;CAC7C,CAAC;AAEX,MAAM,CAAC,MAAM,8BAA8B,GACzC,oEAAoE,CAAC;AAEvE,MAAM,CAAC,MAAM,aAAa,GAAG,4CAA4C,CAAC;AAE1E,MAAM,CAAC,MAAM,MAAM,GAAG,4CAA4C,CAAC;AACnE,MAAM,CAAC,MAAM,MAAM,GAAG,4CAA4C,CAAC;AACnE,MAAM,CAAC,MAAM,MAAM,GAAG,4CAA4C,CAAC;AAEnE,MAAM,UAAU,QAAQ,CAAC,GAAiB;IACxC,+CAA+C;IAC/C,IAAI,SAAS,IAAI,GAAG,IAAI,UAAU,IAAI,GAAG,EAAE,CAAC;QAC1C,IAAI,SAAS,IAAI,GAAG,IAAI,UAAU,IAAI,GAAG;YAAE,OAAO,GAAc,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO;QACL,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC;QAC3B,QAAQ,EAAE,SAAS,CAAC,OAAO,CAAC;KAC7B,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { CatapultarAccount } from "./catapultar/account.js";
+export { CatapultarTx, MetaCatapultarTx } from "./catapultar/catapultar.js";
+export { ConstrainedAssetTransaction } from "./transaction/constrainedtransaction.js";
+export { BaseTransaction } from "./transaction/transaction.js";
+export { ExecutionMode, AccountPublicKeyType } from "./types/types.js";
+export type { AccountPublicVar, Call, Calls, Allowance, Outcome, WebAuthnSignature, } from "./types/types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAEpE,YAAY,EACV,gBAAgB,EAChB,IAAI,EACJ,KAAK,EACL,SAAS,EACT,OAAO,EACP,iBAAiB,GAClB,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { CatapultarAccount } from "./catapultar/account.js";
+export { CatapultarTx, MetaCatapultarTx } from "./catapultar/catapultar.js";
+export { ConstrainedAssetTransaction } from "./transaction/constrainedtransaction.js";
+export { BaseTransaction } from "./transaction/transaction.js";
+export { ExecutionMode, AccountPublicKeyType } from "./types/types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}

package/dist/transaction/constrainedtransaction.d.ts

@@ -0,0 +1,57 @@
+import { type Allowance, type Call, type Outcome } from "../types/types.js";
+import { BaseTransaction } from "./transaction.js";
+/**
+ * Helper class for deploying a Catapultar account with an embedded Constrained Asset Transaction
+ */
+export declare class ConstrainedAssetTransaction {
+    allowances: Allowance[];
+    outcomes: Outcome[];
+    executor: `0x${string}`;
+    chainId: number;
+    constraintNonce: bigint;
+    constructor(opt: {
+        executor: `0x${string}`;
+        chainId: number;
+    });
+    addAllowances(...allowances: Allowance[]): void;
+    /**
+     * Add token outcomes to an asset constraint.
+     * To add the smart account as the recipient (address unknown at this stage), set address(0).
+     */
+    addOutcomes(...outcomes: Outcome[]): void;
+    perpetual(state: boolean): void;
+    /**
+     * Export the constrainted transaction as a BaseTransaction which can be converted to an account.
+     * @param opt.addApprove Whether to approve the tokens on the validator. Default True.
+     * @param opt.refund If provided, refund allowances to this contract. Default none.
+     * @param opt.validator Validator for transaction. Default library validator.
+     * @param opt.executor The constrainted transaction can only be executed by this account. Default this.executor.
+     * @returns BaseTransaction with calls embedded for a constrainted validator.
+     */
+    asCatapultarAllowanceTransaction(opt?: {
+        addApprove?: boolean;
+        refund?: `0x${string}`;
+        validator?: `0x${string}`;
+        executor?: `0x${string}`;
+    }): BaseTransaction;
+    /**
+     * The call for execution the validation on the account.
+     */
+    asExecuteCall(opt: {
+        address: `0x${string}`;
+    } & {
+        executionTarget: `0x${string}`;
+        executionPayload: `0x${string}`;
+        spends: bigint[];
+    } & {
+        refund?: `0x${string}`;
+        validator?: `0x${string}`;
+    }): Call;
+    asRefundCall(opt: {
+        address: `0x${string}`;
+    } & {
+        refund: `0x${string}`;
+        validator?: `0x${string}`;
+    }): Call;
+}
+//# sourceMappingURL=constrainedtransaction.d.ts.map

package/dist/transaction/constrainedtransaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constrainedtransaction.d.ts","sourceRoot":"","sources":["../../src/transaction/constrainedtransaction.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,SAAS,EAEd,KAAK,IAAI,EAET,KAAK,OAAO,EACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAKhD;;GAEG;AACH,qBAAa,2BAA2B;IACtC,UAAU,EAAE,SAAS,EAAE,CAAM;IAC7B,QAAQ,EAAE,OAAO,EAAE,CAAM;IAEzB,QAAQ,EAAE,KAAK,MAAM,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAEhB,eAAe,EAAE,MAAM,CAAM;gBAEjB,GAAG,EAAE;QAAE,QAAQ,EAAE,KAAK,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAM7D,aAAa,CAAC,GAAG,UAAU,EAAE,SAAS,EAAE;IAIxC;;;OAGG;IACH,WAAW,CAAC,GAAG,QAAQ,EAAE,OAAO,EAAE;IAIlC,SAAS,CAAC,KAAK,EAAE,OAAO;IAQxB;;;;;;;OAOG;IACH,gCAAgC,CAAC,GAAG,CAAC,EAAE;QACrC,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,MAAM,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;QACvB,SAAS,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;QAC1B,QAAQ,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;KAC1B;IA6FD;;OAEG;IACH,aAAa,CACX,GAAG,EAAE;QAAE,OAAO,EAAE,KAAK,MAAM,EAAE,CAAA;KAAE,GAAG;QAChC,eAAe,EAAE,KAAK,MAAM,EAAE,CAAC;QAC/B,gBAAgB,EAAE,KAAK,MAAM,EAAE,CAAC;QAChC,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,GAAG;QACF,MAAM,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;QACvB,SAAS,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;KAC3B,GACA,IAAI;IAqCP,YAAY,CACV,GAAG,EAAE;QAAE,OAAO,EAAE,KAAK,MAAM,EAAE,CAAA;KAAE,GAAG;QAChC,MAAM,EAAE,KAAK,MAAM,EAAE,CAAC;QACtB,SAAS,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;KAC3B;CAkCJ"}

package/dist/transaction/constrainedtransaction.js

@@ -0,0 +1,191 @@
+import { encodeFunctionData, erc20Abi, hashTypedData, zeroAddress } from "viem";
+import { DigestApproval, ExecutionConstraintTyped, ExecutionMode, } from "../types/types.js";
+import { BaseTransaction } from "./transaction.js";
+import CATAPULTAR_V0_1_0_ABI from "../abi/catapultarV0.1.0.js";
+import { CAT_VALIDATOR_ABI } from "../abi/CATValidator.js";
+import { cat_validator } from "../config.js";
+/**
+ * Helper class for deploying a Catapultar account with an embedded Constrained Asset Transaction
+ */
+export class ConstrainedAssetTransaction {
+    constructor(opt) {
+        this.allowances = [];
+        this.outcomes = [];
+        this.constraintNonce = 1n;
+        const { executor, chainId } = opt;
+        this.executor = executor;
+        this.chainId = chainId;
+    }
+    addAllowances(...allowances) {
+        this.allowances = [...this.allowances, ...allowances];
+    }
+    /**
+     * Add token outcomes to an asset constraint.
+     * To add the smart account as the recipient (address unknown at this stage), set address(0).
+     */
+    addOutcomes(...outcomes) {
+        this.outcomes = [...this.outcomes, ...outcomes];
+    }
+    perpetual(state) {
+        this.constraintNonce = state
+            ? 0n
+            : this.constraintNonce !== 0n
+                ? this.constraintNonce
+                : 1n;
+    }
+    /**
+     * Export the constrainted transaction as a BaseTransaction which can be converted to an account.
+     * @param opt.addApprove Whether to approve the tokens on the validator. Default True.
+     * @param opt.refund If provided, refund allowances to this contract. Default none.
+     * @param opt.validator Validator for transaction. Default library validator.
+     * @param opt.executor The constrainted transaction can only be executed by this account. Default this.executor.
+     * @returns BaseTransaction with calls embedded for a constrainted validator.
+     */
+    asCatapultarAllowanceTransaction(opt) {
+        const { addApprove = true, refund, validator = cat_validator, executor = this.executor, } = opt ?? {};
+        const calls = [];
+        if (addApprove) {
+            // Allow the validator to pull funds. To actually pull funds, the validator requires a signature.
+            for (const allowance of this.allowances) {
+                calls.push({
+                    to: allowance.token,
+                    data: encodeFunctionData({
+                        abi: erc20Abi,
+                        functionName: "approve",
+                        args: [validator, allowance.amount],
+                    }),
+                    value: 0n,
+                });
+            }
+        }
+        // Set the signature that allows the validator to pull funds.
+        const executionConstraint = {
+            allowances: this.allowances,
+            outcomes: this.outcomes,
+            executor: executor,
+            nonce: this.constraintNonce,
+        };
+        const typehash = hashTypedData({
+            types: ExecutionConstraintTyped,
+            primaryType: "ExecutionConstraint",
+            message: executionConstraint,
+            domain: {
+                chainId: this.chainId,
+                name: "CAT Validator",
+                version: "1",
+                verifyingContract: validator,
+            },
+        });
+        calls.push({
+            to: zeroAddress,
+            value: 0n,
+            data: encodeFunctionData({
+                abi: CATAPULTAR_V0_1_0_ABI,
+                functionName: "setSignature",
+                args: [typehash, DigestApproval.Signature],
+            }),
+        });
+        // If a refund target has been provided, then we add a 1:1 refund.
+        if (refund) {
+            const refundOutcomes = this.allowances.map((allowance) => ({
+                destination: refund,
+                amount: allowance.amount,
+                token: allowance.token,
+            }));
+            const refundExecutionConstraint = {
+                allowances: this.allowances,
+                outcomes: refundOutcomes,
+                executor: executor,
+                nonce: this.constraintNonce,
+            };
+            const typehash = hashTypedData({
+                types: ExecutionConstraintTyped,
+                primaryType: "ExecutionConstraint",
+                message: refundExecutionConstraint,
+                domain: {
+                    chainId: this.chainId,
+                    name: "CAT Validator",
+                    version: "1",
+                    verifyingContract: validator,
+                },
+            });
+            calls.push({
+                to: zeroAddress,
+                value: 0n,
+                data: encodeFunctionData({
+                    abi: CATAPULTAR_V0_1_0_ABI,
+                    functionName: "setSignature",
+                    args: [typehash, DigestApproval.Signature],
+                }),
+            });
+        }
+        const tx = new BaseTransaction();
+        tx.addCall(...calls);
+        tx.setMode(ExecutionMode.RaiseRevert);
+        tx.setNonce(1n);
+        return tx;
+    }
+    /**
+     * The call for execution the validation on the account.
+     */
+    asExecuteCall(opt) {
+        const { validator = cat_validator, executionTarget, executionPayload, } = opt;
+        if (opt.spends.length !== this.allowances.length)
+            throw new Error(`Spends and allowances not same length: Allowances: ${this.allowances.length}, Spends: ${opt.spends.length}`);
+        const allowanceSpends = this.allowances.map((a, i) => ({
+            token: a.token,
+            allocated: a.amount,
+            spend: opt.spends[i],
+        }));
+        const executeCall = {
+            to: validator,
+            data: encodeFunctionData({
+                abi: CAT_VALIDATOR_ABI,
+                functionName: "entry",
+                args: [
+                    executionTarget,
+                    executionPayload,
+                    opt.address,
+                    this.constraintNonce,
+                    allowanceSpends,
+                    this.outcomes,
+                    "0x",
+                ],
+            }),
+            value: 0n,
+        };
+        return executeCall;
+    }
+    asRefundCall(opt) {
+        const { validator = cat_validator } = opt;
+        const allowanceSpends = this.allowances.map((a) => ({
+            token: a.token,
+            allocated: a.amount,
+            spend: a.amount,
+        }));
+        const refundOutcomes = this.allowances.map((a) => ({
+            token: a.token,
+            amount: a.amount,
+            destination: opt.refund,
+        }));
+        const executeCall = {
+            to: validator,
+            data: encodeFunctionData({
+                abi: CAT_VALIDATOR_ABI,
+                functionName: "entry",
+                args: [
+                    opt.refund,
+                    "0x",
+                    opt.address,
+                    this.constraintNonce,
+                    allowanceSpends,
+                    refundOutcomes,
+                    "0x",
+                ],
+            }),
+            value: 0n,
+        };
+        return executeCall;
+    }
+}
+//# sourceMappingURL=constrainedtransaction.js.map

package/dist/transaction/constrainedtransaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constrainedtransaction.js","sourceRoot":"","sources":["../../src/transaction/constrainedtransaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AAChF,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,aAAa,GAMd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,qBAAqB,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C;;GAEG;AACH,MAAM,OAAO,2BAA2B;IAStC,YAAY,GAAiD;QAR7D,eAAU,GAAgB,EAAE,CAAC;QAC7B,aAAQ,GAAc,EAAE,CAAC;QAKzB,oBAAe,GAAW,EAAE,CAAC;QAG3B,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC;QAClC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,aAAa,CAAC,GAAG,UAAuB;QACtC,IAAI,CAAC,UAAU,GAAG,CAAC,GAAG,IAAI,CAAC,UAAU,EAAE,GAAG,UAAU,CAAC,CAAC;IACxD,CAAC;IAED;;;OAGG;IACH,WAAW,CAAC,GAAG,QAAmB;QAChC,IAAI,CAAC,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED,SAAS,CAAC,KAAc;QACtB,IAAI,CAAC,eAAe,GAAG,KAAK;YAC1B,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,IAAI,CAAC,eAAe,KAAK,EAAE;gBAC3B,CAAC,CAAC,IAAI,CAAC,eAAe;gBACtB,CAAC,CAAC,EAAE,CAAC;IACX,CAAC;IAED;;;;;;;OAOG;IACH,gCAAgC,CAAC,GAKhC;QACC,MAAM,EACJ,UAAU,GAAG,IAAI,EACjB,MAAM,EACN,SAAS,GAAG,aAAa,EACzB,QAAQ,GAAG,IAAI,CAAC,QAAQ,GACzB,GAAG,GAAG,IAAI,EAAE,CAAC;QAEd,MAAM,KAAK,GAAW,EAAE,CAAC;QACzB,IAAI,UAAU,EAAE,CAAC;YACf,iGAAiG;YACjG,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACxC,KAAK,CAAC,IAAI,CAAC;oBACT,EAAE,EAAE,SAAS,CAAC,KAAK;oBACnB,IAAI,EAAE,kBAAkB,CAAC;wBACvB,GAAG,EAAE,QAAQ;wBACb,YAAY,EAAE,SAAS;wBACvB,IAAI,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC;qBACpC,CAAC;oBACF,KAAK,EAAE,EAAE;iBACV,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,6DAA6D;QAC7D,MAAM,mBAAmB,GAAwB;YAC/C,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,QAAQ,EAAE,QAAQ;YAClB,KAAK,EAAE,IAAI,CAAC,eAAe;SAC5B,CAAC;QACF,MAAM,QAAQ,GAAG,aAAa,CAAC;YAC7B,KAAK,EAAE,wBAAwB;YAC/B,WAAW,EAAE,qBAAqB;YAClC,OAAO,EAAE,mBAAmB;YAC5B,MAAM,EAAE;gBACN,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,GAAG;gBACZ,iBAAiB,EAAE,SAAS;aAC7B;SACF,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC;YACT,EAAE,EAAE,WAAW;YACf,KAAK,EAAE,EAAE;YACT,IAAI,EAAE,kBAAkB,CAAC;gBACvB,GAAG,EAAE,qBAAqB;gBAC1B,YAAY,EAAE,cAAc;gBAC5B,IAAI,EAAE,CAAC,QAAQ,EAAE,cAAc,CAAC,SAAS,CAAC;aAC3C,CAAC;SACH,CAAC,CAAC;QACH,kEAAkE;QAClE,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,cAAc,GAAc,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;gBACpE,WAAW,EAAE,MAAM;gBACnB,MAAM,EAAE,SAAS,CAAC,MAAM;gBACxB,KAAK,EAAE,SAAS,CAAC,KAAK;aACvB,CAAC,CAAC,CAAC;YAEJ,MAAM,yBAAyB,GAAwB;gBACrD,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,QAAQ,EAAE,cAAc;gBACxB,QAAQ,EAAE,QAAQ;gBAClB,KAAK,EAAE,IAAI,CAAC,eAAe;aAC5B,CAAC;YACF,MAAM,QAAQ,GAAG,aAAa,CAAC;gBAC7B,KAAK,EAAE,wBAAwB;gBAC/B,WAAW,EAAE,qBAAqB;gBAClC,OAAO,EAAE,yBAAyB;gBAClC,MAAM,EAAE;oBACN,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,IAAI,EAAE,eAAe;oBACrB,OAAO,EAAE,GAAG;oBACZ,iBAAiB,EAAE,SAAS;iBAC7B;aACF,CAAC,CAAC;YACH,KAAK,CAAC,IAAI,CAAC;gBACT,EAAE,EAAE,WAAW;gBACf,KAAK,EAAE,EAAE;gBACT,IAAI,EAAE,kBAAkB,CAAC;oBACvB,GAAG,EAAE,qBAAqB;oBAC1B,YAAY,EAAE,cAAc;oBAC5B,IAAI,EAAE,CAAC,QAAQ,EAAE,cAAc,CAAC,SAAS,CAAC;iBAC3C,CAAC;aACH,CAAC,CAAC;QACL,CAAC;QAED,MAAM,EAAE,GAAG,IAAI,eAAe,EAAE,CAAC;QACjC,EAAE,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;QACrB,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;QACtC,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;OAEG;IACH,aAAa,CACX,GAOC;QAED,MAAM,EACJ,SAAS,GAAG,aAAa,EACzB,eAAe,EACf,gBAAgB,GACjB,GAAG,GAAG,CAAC;QAER,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC,UAAU,CAAC,MAAM;YAC9C,MAAM,IAAI,KAAK,CACb,sDAAsD,IAAI,CAAC,UAAU,CAAC,MAAM,aAAa,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,CAC7G,CAAC;QACJ,MAAM,eAAe,GAAqB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YACvE,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,SAAS,EAAE,CAAC,CAAC,MAAM;YACnB,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAE;SACtB,CAAC,CAAC,CAAC;QAEJ,MAAM,WAAW,GAAS;YACxB,EAAE,EAAE,SAAS;YACb,IAAI,EAAE,kBAAkB,CAAC;gBACvB,GAAG,EAAE,iBAAiB;gBACtB,YAAY,EAAE,OAAO;gBACrB,IAAI,EAAE;oBACJ,eAAe;oBACf,gBAAgB;oBAChB,GAAG,CAAC,OAAO;oBACX,IAAI,CAAC,eAAe;oBACpB,eAAe;oBACf,IAAI,CAAC,QAAQ;oBACb,IAAI;iBACL;aACF,CAAC;YACF,KAAK,EAAE,EAAE;SACV,CAAC;QACF,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,YAAY,CACV,GAGC;QAED,MAAM,EAAE,SAAS,GAAG,aAAa,EAAE,GAAG,GAAG,CAAC;QAE1C,MAAM,eAAe,GAAqB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACpE,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,SAAS,EAAE,CAAC,CAAC,MAAM;YACnB,KAAK,EAAE,CAAC,CAAC,MAAM;SAChB,CAAC,CAAC,CAAC;QACJ,MAAM,cAAc,GAAc,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5D,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,WAAW,EAAE,GAAG,CAAC,MAAM;SACxB,CAAC,CAAC,CAAC;QAEJ,MAAM,WAAW,GAAS;YACxB,EAAE,EAAE,SAAS;YACb,IAAI,EAAE,kBAAkB,CAAC;gBACvB,GAAG,EAAE,iBAAiB;gBACtB,YAAY,EAAE,OAAO;gBACrB,IAAI,EAAE;oBACJ,GAAG,CAAC,MAAM;oBACV,IAAI;oBACJ,GAAG,CAAC,OAAO;oBACX,IAAI,CAAC,eAAe;oBACpB,eAAe;oBACf,cAAc;oBACd,IAAI;iBACL;aACF,CAAC;YACF,KAAK,EAAE,EAAE;SACV,CAAC;QACF,OAAO,WAAW,CAAC;IACrB,CAAC;CACF"}

package/dist/transaction/transaction.d.ts

@@ -0,0 +1,88 @@
+import { AccountPublicKeyType, ExecutionMode, type Call, type MaybeFactory, type Pubkey } from "../types/types.js";
+export declare class BaseTransaction {
+    /** Transaction ExecutionMode, defines transaction behavior for call reverts. */
+    mode?: ExecutionMode;
+    /** Transaction nonce. Only 1 transaction can be executed for each nonce. */
+    nonce?: bigint;
+    /** List of calls the transaction contains. */
+    calls: Call[];
+    signature?: `0x${string}`;
+    constructor(opt?: {
+        mode?: ExecutionMode;
+        nonce?: bigint;
+        calls?: Call[];
+        signature?: `0x${string}`;
+    });
+    /**
+     * Set the transaction nonce for the Catapultar transaction. Only 1 transaction can ever be executed for each nonce.
+     */
+    setNonce(nonce: bigint): this;
+    /**
+     * Generates a random uint256 nonce and sets it.
+     */
+    setRandomNonce(): this;
+    /**
+     * Sets the Catapultar transaction mode.
+     */
+    setMode(mode: ExecutionMode): this;
+    /**
+     * Adds list of calls to the Catapultar transaction. The calls will be executed with the configured mode.
+     */
+    addCall(...calls: Call[]): this;
+    /**
+     * @returns Total value of all contained calls.
+     */
+    getTotalValue(): bigint;
+    hasValidMode(): boolean;
+    /**
+     * @returns Whether the a multichain execution mode is set.
+     */
+    hasMultichainMode(): boolean;
+    /**
+     * Returns the signature as a compact signature of 64 bytes instead of 65 bytes.
+     *
+     * @param Signature If provided, will act on the provided signature instead.
+     */
+    asCompactSignature(signature?: `0x${string}`): `0x${string}`;
+    /**
+     * @dev Opdata is nonce + signature packed.
+     * If no signature has been provided to the object, it will create the transaction without a signatures. This can be used to sub-batch the transaction.
+     */
+    getOpData(options?: {
+        compactSignature: boolean;
+    }): `0x${string}`;
+    getExecutionData(): `0x${string}`;
+    /** @return As parameters for an execute call. */
+    asParameters(): {
+        mode: ExecutionMode | undefined;
+        executionData: `0x${string}`;
+        metadata: {
+            value: bigint;
+            signature: `0x${string}` | undefined;
+        };
+    };
+    /**
+     * @return As a call for further scheduling or manual transaction signing. If used for manual transaction.
+     */
+    asCallData(): Omit<Call, "to">;
+    /** Return the calls as an approval diget. This can be used to "embed" the calls into an account */
+    asDigest(): `0x${string}`;
+    /** Generate an account with this action embedded. */
+    asAccount<AKT extends AccountPublicKeyType>(opt: {
+        salt: `0x${string}`;
+    } & Pubkey<AKT> & MaybeFactory): {
+        deployCall: {
+            to: `0x${string}`;
+            data: `0x${string}`;
+            value: bigint;
+        };
+        actionCall: {
+            to: `0x${string}`;
+            value: bigint;
+            data: `0x${string}`;
+        };
+        callDigest: `0x${string}`;
+        address: `0x${string}`;
+    };
+}
+//# sourceMappingURL=transaction.d.ts.map

package/dist/transaction/transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../../src/transaction/transaction.ts"],"names":[],"mappings":"AACA,OAAO,EACL,oBAAoB,EAEpB,aAAa,EACb,KAAK,IAAI,EACT,KAAK,YAAY,EACjB,KAAK,MAAM,EACZ,MAAM,gBAAgB,CAAC;AAQxB,qBAAa,eAAe;IAC1B,gFAAgF;IAChF,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,KAAK,EAAE,IAAI,EAAE,CAAC;IAEd,SAAS,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;gBAEd,GAAG,CAAC,EAAE;QAChB,IAAI,CAAC,EAAE,aAAa,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;QACf,SAAS,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;KAC3B;IAUD;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM;IAStB;;OAEG;IACH,cAAc;IAId;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,aAAa;IAK3B;;OAEG;IACH,OAAO,CAAC,GAAG,KAAK,EAAE,IAAI,EAAE;IASxB;;OAEG;IACH,aAAa,IAAI,MAAM;IAMvB,YAAY;IAKZ;;OAEG;IACH,iBAAiB,IAAI,OAAO;IAO5B;;;;OAIG;IACH,kBAAkB,CAAC,SAAS,CAAC,EAAE,KAAK,MAAM,EAAE,GAAG,KAAK,MAAM,EAAE;IAU5D;;;OAGG;IACH,SAAS,CAAC,OAAO,CAAC,EAAE;QAAE,gBAAgB,EAAE,OAAO,CAAA;KAAE,GAAG,KAAK,MAAM,EAAE;IAmBjE,gBAAgB;IAShB,iDAAiD;IACjD,YAAY;;;;;;;;IAWZ;;OAEG;IACH,UAAU,IAAI,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC;IAe9B,mGAAmG;IACnG,QAAQ;IAgBR,qDAAqD;IACrD,SAAS,CAAC,GAAG,SAAS,oBAAoB,EACxC,GAAG,EAAE;QACH,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;KACrB,GAAG,MAAM,CAAC,GAAG,CAAC,GACb,YAAY;;;;;;;;;;;;;;CA+BjB"}