@clawnch/clawncher-sdk 0.3.2 → 0.3.4

package/dist/herd-auth.js.map

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

package/dist/herd-hal.d.ts

@@ -0,0 +1,92 @@
+/**
+ * HAL Expression Builder — Programmatic construction of Herd Action Language expressions.
+ *
+ * HAL (Herd Action Language) is a JSON DSL for composing blockchain transactions
+ * and data reads. Instead of requiring users to hand-write the nested JSON,
+ * this module provides a TypeScript builder API.
+ *
+ * Use cases:
+ *   - Pre-simulate any transaction before sending
+ *   - Generate reusable adapters for common Clawncher operations
+ *   - Validate parameter types at compile time
+ *
+ * @example
+ * ```typescript
+ * const hal = new HalBuilder();
+ *
+ * // Build an ERC-20 transfer adapter
+ * const expr = hal.buildTransferAdapter({
+ *   token: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
+ *   blockchain: 'base',
+ *   decimals: 6,
+ * });
+ *
+ * // Simulate it via Herd
+ * const result = await herd.simulateAction(expr, {
+ *   to: '0xRecipient...',
+ *   amount: '100',
+ * });
+ * ```
+ */
+import type { HerdBlockchain, HalExpression, HalSimulationResult } from './herd-types.js';
+export interface TransferAdapterOptions {
+    /** Token contract address */
+    token: string;
+    /** Blockchain */
+    blockchain: HerdBlockchain;
+    /** Token decimals (default: 18) */
+    decimals?: number;
+    /** Token name for metadata */
+    tokenName?: string;
+}
+export interface SwapActionOptions {
+    /** Sell token address */
+    sellToken: string;
+    /** Buy token address */
+    buyToken: string;
+    /** Blockchain */
+    blockchain: HerdBlockchain;
+    /** Whether to include the approval step */
+    includeApproval?: boolean;
+}
+export interface ReadBalanceOptions {
+    /** Token contract address */
+    token: string;
+    /** Blockchain */
+    blockchain: HerdBlockchain;
+}
+export declare class HalBuilder {
+    /**
+     * Build a HAL adapter expression for an ERC-20 transfer.
+     *
+     * Parameters exposed to the user: `to` (address), `amount` (human-readable).
+     * The adapter handles decimal conversion and calldata encoding.
+     */
+    buildTransferAdapter(options: TransferAdapterOptions): HalExpression;
+    /**
+     * Build a HAL action for a swap using 0x API.
+     *
+     * This generates an action with an optional approval step (conditional
+     * on whether the wallet has already approved the spender).
+     */
+    buildSwapAction(options: SwapActionOptions): HalExpression;
+    /**
+     * Build a HAL read adapter for checking an ERC-20 balance.
+     */
+    buildBalanceReader(options: ReadBalanceOptions): HalExpression;
+    /**
+     * Build a HAL read adapter for checking allowance.
+     */
+    buildAllowanceReader(options: ReadBalanceOptions & {
+        spender?: string;
+    }): HalExpression;
+    /**
+     * Build a HAL approve adapter.
+     */
+    buildApproveAdapter(options: TransferAdapterOptions): HalExpression;
+}
+/**
+ * Parse a raw HAL simulation response into typed structure.
+ */
+export declare function parseSimulationResult(raw: unknown): HalSimulationResult;
+//# sourceMappingURL=herd-hal.d.ts.map

package/dist/herd-hal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"herd-hal.d.ts","sourceRoot":"","sources":["../src/herd-hal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EAEb,mBAAmB,EAEpB,MAAM,iBAAiB,CAAC;AAiJzB,MAAM,WAAW,sBAAsB;IACrC,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,UAAU,EAAE,cAAc,CAAC;IAC3B,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB;IACjB,UAAU,EAAE,cAAc,CAAC;IAC3B,2CAA2C;IAC3C,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,UAAU,EAAE,cAAc,CAAC;CAC5B;AAED,qBAAa,UAAU;IACrB;;;;;OAKG;IACH,oBAAoB,CAAC,OAAO,EAAE,sBAAsB,GAAG,aAAa;IA4CpE;;;;;OAKG;IACH,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,aAAa;IAuE1D;;OAEG;IACH,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,GAAG,aAAa;IAqC9D;;OAEG;IACH,oBAAoB,CAAC,OAAO,EAAE,kBAAkB,GAAG;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,aAAa;IAyCvF;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,sBAAsB,GAAG,aAAa;CA2CpE;AAMD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,mBAAmB,CAkBvE"}

package/dist/herd-hal.js

@@ -0,0 +1,337 @@
+/**
+ * HAL Expression Builder — Programmatic construction of Herd Action Language expressions.
+ *
+ * HAL (Herd Action Language) is a JSON DSL for composing blockchain transactions
+ * and data reads. Instead of requiring users to hand-write the nested JSON,
+ * this module provides a TypeScript builder API.
+ *
+ * Use cases:
+ *   - Pre-simulate any transaction before sending
+ *   - Generate reusable adapters for common Clawncher operations
+ *   - Validate parameter types at compile time
+ *
+ * @example
+ * ```typescript
+ * const hal = new HalBuilder();
+ *
+ * // Build an ERC-20 transfer adapter
+ * const expr = hal.buildTransferAdapter({
+ *   token: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
+ *   blockchain: 'base',
+ *   decimals: 6,
+ * });
+ *
+ * // Simulate it via Herd
+ * const result = await herd.simulateAction(expr, {
+ *   to: '0xRecipient...',
+ *   amount: '100',
+ * });
+ * ```
+ */
+// =========================================================================
+// Function Signatures (4-byte selectors)
+// =========================================================================
+const SELECTORS = {
+    transfer: '0xa9059cbb', // transfer(address,uint256)
+    approve: '0x095ea7b3', // approve(address,uint256)
+    balanceOf: '0x70a08231', // balanceOf(address)
+    allowance: '0xdd62ed3e', // allowance(address,address)
+    totalSupply: '0x18160ddd', // totalSupply()
+};
+// =========================================================================
+// HAL Expression Helpers (build individual nodes)
+// =========================================================================
+/**
+ * Create a ["do", ...] block — the top-level wrapper.
+ */
+function doBlock(...exprs) {
+    return ['do', ...exprs];
+}
+/**
+ * Create an ["import", module, [functions]] node.
+ */
+function importStdlib(module, functions) {
+    return ['import', module, functions];
+}
+/**
+ * Create a ["define", { name, parameters, body, meta? }] node.
+ */
+function define(name, parameters, body, meta) {
+    const def = { name, parameters, body };
+    if (meta)
+        def.meta = meta;
+    return ['define', def];
+}
+/**
+ * Create an ["export", ...] wrapper.
+ */
+function exportExpr(expr) {
+    return ['export', expr];
+}
+/**
+ * Create a ["coerce", { type, value }] node.
+ */
+function coerce(type, value) {
+    return ['coerce', { type, value }];
+}
+/**
+ * Create an ["encode-calldata", { ... }] node.
+ */
+function encodeCalldata(params) {
+    return [
+        'encode-calldata',
+        {
+            blockchain: params.blockchain,
+            contractAddress: params.contractAddress,
+            functionSignature: params.functionSignature,
+            args: params.args,
+            inputAbi: ['quote', params.inputAbi],
+            functionName: params.functionName,
+        },
+    ];
+}
+/**
+ * Create a ["decimals", { value, decimals }] node.
+ */
+function decimalsExpr(value, decimals) {
+    return ['decimals', { value, decimals }];
+}
+/**
+ * Create a ["write-function", <data>] node for use in batch steps.
+ */
+function writeFunction(data) {
+    return ['write-function', data];
+}
+/**
+ * Create a ["read-function", { calldata, outputAbi }] node.
+ */
+function readFunction(calldata, outputAbi) {
+    return [
+        'read-function',
+        {
+            calldata,
+            outputAbi: ['quote', outputAbi],
+        },
+    ];
+}
+/**
+ * Create a batch call data return value (for write adapters).
+ */
+function batchCallData(payable, payableAmount, encodedCalldata) {
+    return [
+        'coerce',
+        {
+            type: {
+                payable: 'bool',
+                payableAmount: 'uint256',
+                encodedCalldata: {
+                    blockchain: 'string',
+                    contractAddress: 'address',
+                    functionSignature: 'bytes4',
+                    calldata: 'bytes',
+                },
+            },
+            value: {
+                payable,
+                payableAmount,
+                encodedCalldata,
+            },
+        },
+    ];
+}
+export class HalBuilder {
+    /**
+     * Build a HAL adapter expression for an ERC-20 transfer.
+     *
+     * Parameters exposed to the user: `to` (address), `amount` (human-readable).
+     * The adapter handles decimal conversion and calldata encoding.
+     */
+    buildTransferAdapter(options) {
+        const decimals = options.decimals ?? 18;
+        return doBlock(importStdlib('herd', ['encode-calldata', 'decimals']), exportExpr(define('transfer', [
+            { name: 'to', type: 'address', meta: { description: 'Recipient address' } },
+            { name: 'amount', type: 'uint256', meta: { description: 'Amount (human-readable)', decimals } },
+        ], batchCallData(false, '0', encodeCalldata({
+            blockchain: options.blockchain,
+            contractAddress: options.token,
+            functionSignature: SELECTORS.transfer,
+            args: {
+                recipient: 'to',
+                value: coerce('uint256', decimalsExpr('amount', decimals)),
+            },
+            inputAbi: [
+                { name: 'recipient', type: 'address' },
+                { name: 'value', type: 'uint256' },
+            ],
+            functionName: 'transfer',
+        })), {
+            description: `Transfer ${options.tokenName || 'tokens'}`,
+            originContract: {
+                address: options.token,
+                blockchain: options.blockchain,
+                contractName: options.tokenName || 'ERC20',
+                functionName: 'transfer',
+            },
+        })));
+    }
+    /**
+     * Build a HAL action for a swap using 0x API.
+     *
+     * This generates an action with an optional approval step (conditional
+     * on whether the wallet has already approved the spender).
+     */
+    buildSwapAction(options) {
+        const includeApproval = options.includeApproval !== false;
+        const swapCall = [
+            'swap',
+            {
+                blockchain: options.blockchain,
+                sellTokenAddress: options.sellToken,
+                sellTokenAmount: 'amount',
+                buyTokenAddress: options.buyToken,
+                walletAddress: ['user-wallet'],
+                divideDecimals: false,
+            },
+        ];
+        const swapStep = writeFunction([
+            'getPath',
+            {
+                object: swapCall,
+                path: ['quote', ['swapSteps', 'swap']],
+            },
+        ]);
+        const steps = [];
+        if (includeApproval) {
+            // Conditional approval: only add if approvalRequired is true
+            steps.push([
+                'if',
+                [
+                    'getPath',
+                    {
+                        object: swapCall,
+                        path: ['quote', ['swapSteps', 'approval', 'approvalRequired']],
+                    },
+                ],
+                writeFunction([
+                    'getPath',
+                    {
+                        object: swapCall,
+                        path: ['quote', ['swapSteps', 'approval']],
+                    },
+                ]),
+                null,
+            ]);
+        }
+        steps.push(swapStep);
+        return doBlock(importStdlib('herd', ['swap', 'write-function', 'user-wallet']), importStdlib('object', ['getPath']), exportExpr(define('main', [
+            { name: 'amount', type: 'uint256', meta: { description: 'Sell amount (human-readable)' } },
+        ], [
+            define('batch0', [], steps, { isBatch: true, batchLabel: 'Swap Tokens' }),
+        ])));
+    }
+    /**
+     * Build a HAL read adapter for checking an ERC-20 balance.
+     */
+    buildBalanceReader(options) {
+        return doBlock(importStdlib('herd', ['encode-calldata', 'read-function']), exportExpr(define('checkBalance', [
+            { name: 'account', type: 'address', meta: { description: 'Wallet to check' } },
+        ], coerce({ balance: 'uint256' }, readFunction(encodeCalldata({
+            blockchain: options.blockchain,
+            contractAddress: options.token,
+            functionSignature: SELECTORS.balanceOf,
+            args: { account: 'account' },
+            inputAbi: [{ name: 'account', type: 'address' }],
+            functionName: 'balanceOf',
+        }), [{ name: 'balance', type: 'uint256' }])), {
+            description: 'Check ERC-20 token balance',
+            originContract: {
+                address: options.token,
+                blockchain: options.blockchain,
+                contractName: 'ERC20',
+                functionName: 'balanceOf',
+            },
+        })));
+    }
+    /**
+     * Build a HAL read adapter for checking allowance.
+     */
+    buildAllowanceReader(options) {
+        return doBlock(importStdlib('herd', ['encode-calldata', 'read-function']), exportExpr(define('checkAllowance', [
+            { name: 'owner', type: 'address' },
+            { name: 'spender', type: 'address' },
+        ], coerce({ remaining: 'uint256' }, readFunction(encodeCalldata({
+            blockchain: options.blockchain,
+            contractAddress: options.token,
+            functionSignature: SELECTORS.allowance,
+            args: { owner: 'owner', spender: 'spender' },
+            inputAbi: [
+                { name: 'owner', type: 'address' },
+                { name: 'spender', type: 'address' },
+            ],
+            functionName: 'allowance',
+        }), [{ name: 'remaining', type: 'uint256' }])), {
+            description: 'Check ERC-20 token allowance',
+            originContract: {
+                address: options.token,
+                blockchain: options.blockchain,
+                contractName: 'ERC20',
+                functionName: 'allowance',
+            },
+        })));
+    }
+    /**
+     * Build a HAL approve adapter.
+     */
+    buildApproveAdapter(options) {
+        const decimals = options.decimals ?? 18;
+        return doBlock(importStdlib('herd', ['encode-calldata', 'decimals']), exportExpr(define('approve', [
+            { name: 'spender', type: 'address', meta: { description: 'Spender address' } },
+            { name: 'amount', type: 'uint256', meta: { description: 'Approval amount', decimals } },
+        ], batchCallData(false, '0', encodeCalldata({
+            blockchain: options.blockchain,
+            contractAddress: options.token,
+            functionSignature: SELECTORS.approve,
+            args: {
+                spender: 'spender',
+                value: coerce('uint256', decimalsExpr('amount', decimals)),
+            },
+            inputAbi: [
+                { name: 'spender', type: 'address' },
+                { name: 'value', type: 'uint256' },
+            ],
+            functionName: 'approve',
+        })), {
+            description: `Approve ${options.tokenName || 'token'} spending`,
+            originContract: {
+                address: options.token,
+                blockchain: options.blockchain,
+                contractName: options.tokenName || 'ERC20',
+                functionName: 'approve',
+            },
+        })));
+    }
+}
+// =========================================================================
+// Simulation Result Parsing
+// =========================================================================
+/**
+ * Parse a raw HAL simulation response into typed structure.
+ */
+export function parseSimulationResult(raw) {
+    const data = (raw || {});
+    const oplog = (data.entries || data.oplog || []).map((entry) => ({
+        operationId: entry.operationId || '',
+        functionName: entry.functionName || '',
+        status: entry.status || 'success',
+        timestamp: entry.timestamp || entry.timestampIso || '',
+        args: entry.args,
+        result: entry.result,
+    }));
+    return {
+        success: data.executionStatus === 'completed' || data.success === true,
+        finalResult: data.finalResult ?? data.result ?? null,
+        oplog,
+        error: data.error || null,
+    };
+}
+//# sourceMappingURL=herd-hal.js.map

package/dist/herd-hal.js.map

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