@4mica/sdk 1.2.17 → 1.3.1

package/dist/src/config.js

@@ -1,197 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ConfigBuilder = void 0;
-const accounts_1 = require("viem/accounts");
-const errors_1 = require("./errors");
-const utils_1 = require("./utils");
-const networks_1 = require("./networks");
-/**
- * Fluent builder for {@link Config}.
- *
- * @example
- * ```ts
- * const cfg = new ConfigBuilder()
- *   .walletPrivateKey('0x...')
- *   .build();
- * ```
- *
- * All fields can also be supplied from environment variables via {@link fromEnv}.
- */
-class ConfigBuilder {
-    _rpcUrl = 'https://ethereum.sepolia.api.4mica.xyz/';
-    _walletPrivateKey;
-    _signer;
-    _ethereumHttpRpcUrl;
-    _contractAddress;
-    _adminApiKey;
-    _bearerToken;
-    _authEnabled = true;
-    _authUrl;
-    _authRefreshMarginSecs;
-    /** Set the 4Mica core RPC URL directly. Use {@link network} to select a hosted network by name instead. Defaults to `https://ethereum.sepolia.api.4mica.xyz/`. */
-    rpcUrl(value) {
-        this._rpcUrl = value;
-        return this;
-    }
-    /**
-     * Select a hosted 4Mica network by shorthand or CAIP-2 identifier.
-     * Resolves to the corresponding core API URL.
-     * Mutually exclusive with {@link rpcUrl} — last call wins.
-     *
-     * Supported values: `"base"` / `"eip155:8453"`, `"base-sepolia"` / `"eip155:84532"`,
-     * `"ethereum-sepolia"` / `"eip155:11155111"`.
-     *
-     * @throws {@link ConfigError} if the network is not recognised.
-     *
-     * @example
-     * ```ts
-     * new ConfigBuilder().network("base").walletPrivateKey("0x...").build();
-     * new ConfigBuilder().network("eip155:8453").walletPrivateKey("0x...").build();
-     * ```
-     */
-    network(value) {
-        const url = (0, networks_1.resolveNetworkRpcUrl)(value);
-        if (!url) {
-            throw new errors_1.ConfigError(`unknown network "${value}". Use a known shorthand (e.g. "base") or CAIP-2 id, or call rpcUrl() directly.`);
-        }
-        this._rpcUrl = url;
-        return this;
-    }
-    /** Set the wallet private key (hex string). Mutually exclusive with {@link signer}. */
-    walletPrivateKey(value) {
-        this._walletPrivateKey = value;
-        return this;
-    }
-    /** Set a pre-built viem `Account` directly. Mutually exclusive with {@link walletPrivateKey}. */
-    signer(value) {
-        this._signer = value;
-        return this;
-    }
-    /** Override the Ethereum HTTP RPC URL used for on-chain calls. */
-    ethereumHttpRpcUrl(value) {
-        this._ethereumHttpRpcUrl = value;
-        return this;
-    }
-    /** Override the Core4Mica contract address. */
-    contractAddress(value) {
-        this._contractAddress = value;
-        return this;
-    }
-    /** Set an admin API key for privileged RPC endpoints. */
-    adminApiKey(value) {
-        this._adminApiKey = value;
-        return this;
-    }
-    /** Set a static bearer token for authenticated RPC calls. Disables SIWE auth. */
-    bearerToken(value) {
-        this._bearerToken = value;
-        return this;
-    }
-    /** Enable SIWE authentication using the default RPC URL as the auth endpoint. Auth is enabled by default; this is a no-op unless you previously called a method that disabled it. */
-    enableAuth() {
-        this._authEnabled = true;
-        return this;
-    }
-    /** Set a custom SIWE authentication endpoint and enable auth. */
-    authUrl(value) {
-        this._authUrl = value;
-        this._authEnabled = true;
-        return this;
-    }
-    /** Set the number of seconds before token expiry at which the session proactively refreshes. Enables auth. */
-    authRefreshMarginSecs(value) {
-        this._authRefreshMarginSecs = value;
-        this._authEnabled = true;
-        return this;
-    }
-    /**
-     * Load configuration from environment variables.
-     *
-     * Recognised variables:
-     * - `4MICA_NETWORK` — shorthand or CAIP-2 id (e.g. `base`); takes precedence over `4MICA_RPC_URL`
-     * - `4MICA_RPC_URL`
-     * - `4MICA_WALLET_PRIVATE_KEY`
-     * - `4MICA_ETHEREUM_HTTP_RPC_URL`
-     * - `4MICA_CONTRACT_ADDRESS`
-     * - `4MICA_ADMIN_API_KEY`
-     * - `4MICA_BEARER_TOKEN`
-     * - `4MICA_AUTH_URL`
-     * - `4MICA_AUTH_REFRESH_MARGIN_SECS`
-     */
-    fromEnv() {
-        const env = process.env;
-        if (env['4MICA_NETWORK'])
-            this.network(env['4MICA_NETWORK']);
-        else if (env['4MICA_RPC_URL'])
-            this._rpcUrl = env['4MICA_RPC_URL'];
-        if (env['4MICA_WALLET_PRIVATE_KEY'])
-            this._walletPrivateKey = env['4MICA_WALLET_PRIVATE_KEY'];
-        if (env['4MICA_ETHEREUM_HTTP_RPC_URL'])
-            this._ethereumHttpRpcUrl = env['4MICA_ETHEREUM_HTTP_RPC_URL'];
-        if (env['4MICA_CONTRACT_ADDRESS'])
-            this._contractAddress = env['4MICA_CONTRACT_ADDRESS'];
-        if (env['4MICA_ADMIN_API_KEY'])
-            this._adminApiKey = env['4MICA_ADMIN_API_KEY'];
-        if (env['4MICA_BEARER_TOKEN'])
-            this._bearerToken = env['4MICA_BEARER_TOKEN'];
-        if (env['4MICA_AUTH_URL']) {
-            this._authUrl = env['4MICA_AUTH_URL'];
-            this._authEnabled = true;
-        }
-        if (env['4MICA_AUTH_REFRESH_MARGIN_SECS']) {
-            this._authRefreshMarginSecs = Number(env['4MICA_AUTH_REFRESH_MARGIN_SECS']);
-            this._authEnabled = true;
-        }
-        return this;
-    }
-    /**
-     * Validate all settings and return an immutable {@link Config}.
-     *
-     * @throws {@link ConfigError} if required fields are missing, URLs are invalid,
-     *   or the auth refresh margin is not a finite non-negative number.
-     */
-    build() {
-        if (!this._signer && !this._walletPrivateKey) {
-            throw new errors_1.ConfigError('missing signer or wallet_private_key');
-        }
-        if (!this._rpcUrl) {
-            throw new errors_1.ConfigError('missing rpc_url');
-        }
-        try {
-            const rpcUrl = (0, utils_1.validateUrl)(this._rpcUrl);
-            const walletPrivateKey = this._walletPrivateKey
-                ? (0, utils_1.normalizePrivateKey)(this._walletPrivateKey)
-                : undefined;
-            const signer = this._signer ?? (0, accounts_1.privateKeyToAccount)(walletPrivateKey);
-            const ethereumHttpRpcUrl = this._ethereumHttpRpcUrl
-                ? (0, utils_1.validateUrl)(this._ethereumHttpRpcUrl)
-                : undefined;
-            const contractAddress = this._contractAddress
-                ? (0, utils_1.normalizeAddress)(this._contractAddress)
-                : undefined;
-            const authUrl = this._authUrl ? (0, utils_1.validateUrl)(this._authUrl) : undefined;
-            const refreshMargin = this._authRefreshMarginSecs !== undefined ? this._authRefreshMarginSecs : 60;
-            if (!Number.isFinite(refreshMargin) || refreshMargin < 0) {
-                throw new utils_1.ValidationError('invalid auth refresh margin');
-            }
-            const authEnabled = this._authEnabled;
-            return {
-                rpcUrl,
-                signer,
-                ethereumHttpRpcUrl,
-                contractAddress,
-                adminApiKey: this._adminApiKey,
-                bearerToken: this._bearerToken,
-                authUrl: authEnabled ? (authUrl ?? rpcUrl) : undefined,
-                authRefreshMarginSecs: authEnabled ? refreshMargin : undefined,
-            };
-        }
-        catch (err) {
-            if (err instanceof utils_1.ValidationError) {
-                throw new errors_1.ConfigError(err.message);
-            }
-            throw err;
-        }
-    }
-}
-exports.ConfigBuilder = ConfigBuilder;

package/dist/src/constants.d.ts

@@ -1,4 +0,0 @@
-export declare const ADMIN_API_KEY_HEADER = "x-api-key";
-export declare const ADMIN_API_KEY_PREFIX = "ak_";
-export declare const ADMIN_SCOPE_SUSPEND_USERS = "user_suspension:write";
-export declare const ADMIN_SCOPE_MANAGE_KEYS = "admin_api_keys:manage";

package/dist/src/constants.js

@@ -1,7 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ADMIN_SCOPE_MANAGE_KEYS = exports.ADMIN_SCOPE_SUSPEND_USERS = exports.ADMIN_API_KEY_PREFIX = exports.ADMIN_API_KEY_HEADER = void 0;
-exports.ADMIN_API_KEY_HEADER = 'x-api-key';
-exports.ADMIN_API_KEY_PREFIX = 'ak_';
-exports.ADMIN_SCOPE_SUSPEND_USERS = 'user_suspension:write';
-exports.ADMIN_SCOPE_MANAGE_KEYS = 'admin_api_keys:manage';

package/dist/src/contract.d.ts

@@ -1,55 +0,0 @@
-import { createPublicClient, createWalletClient, type Hex, type Chain, Account, GetContractReturnType, HttpTransport } from 'viem';
-import { core4micaAbi } from './abi/core4mica';
-type TPublicClient = ReturnType<typeof createPublicClient>;
-type TWalletClient = ReturnType<typeof createWalletClient<HttpTransport, Chain, Account>>;
-type CoreContract = GetContractReturnType<typeof core4micaAbi, {
-    public: ReturnType<typeof createPublicClient>;
-    wallet: TWalletClient;
-}>;
-export type TxReceiptWaitOptions = {
-    timeout?: number;
-    pollingInterval?: number;
-    gas?: bigint;
-};
-export declare class ContractGateway {
-    readonly publicClient: TPublicClient;
-    readonly walletClient: TWalletClient;
-    readonly contract: CoreContract;
-    private erc20Cache;
-    private txQueue;
-    private constructor();
-    static create(rpcUrl: string, signer: Account, contractAddress: Hex, chainId: number): Promise<ContractGateway>;
-    private erc20;
-    private enqueueTx;
-    private defaultFeeParams;
-    private splitWaitOptions;
-    getGuaranteeDomain(): Promise<string>;
-    getGuaranteeVersionConfig(version: number): Promise<{
-        domainSeparator: string;
-        decoder: string;
-        enabled: boolean;
-    }>;
-    approveErc20(token: string, amount: number | bigint | string, waitOptions?: TxReceiptWaitOptions): Promise<import("viem").TransactionReceipt | undefined>;
-    private waitForErc20Allowance;
-    deposit(amount: number | bigint | string, erc20Token?: string, waitOptions?: TxReceiptWaitOptions): Promise<import("viem").TransactionReceipt>;
-    getUserAssets(opts?: {
-        blockNumber?: bigint;
-    }): Promise<{
-        asset: `0x${string}`;
-        collateral: bigint;
-        withdrawalRequestTimestamp: bigint;
-        withdrawalRequestAmount: bigint;
-    }[]>;
-    getPaymentStatus(tabId: number | bigint): Promise<{
-        paid: bigint;
-        remunerated: boolean;
-        asset: Hex;
-    }>;
-    payTabEth(tabId: number | bigint, reqId: number | bigint, amount: number | bigint | string, recipient: string, waitOptions?: TxReceiptWaitOptions): Promise<import("viem").TransactionReceipt>;
-    payTabErc20(tabId: number | bigint, amount: number | bigint | string, erc20Token: string, recipient: string, waitOptions?: TxReceiptWaitOptions): Promise<import("viem").TransactionReceipt>;
-    requestWithdrawal(amount: number | bigint | string, erc20Token?: string, waitOptions?: TxReceiptWaitOptions): Promise<import("viem").TransactionReceipt>;
-    cancelWithdrawal(erc20Token?: string, waitOptions?: TxReceiptWaitOptions): Promise<import("viem").TransactionReceipt>;
-    finalizeWithdrawal(erc20Token?: string, waitOptions?: TxReceiptWaitOptions): Promise<import("viem").TransactionReceipt>;
-    remunerate(claimsBlob: Uint8Array, signatureWords: Uint8Array[], waitOptions?: TxReceiptWaitOptions): Promise<import("viem").TransactionReceipt>;
-}
-export {};

package/dist/src/contract.js

@@ -1,312 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ContractGateway = void 0;
-const viem_1 = require("viem");
-const core4mica_1 = require("./abi/core4mica");
-const chain_1 = require("./chain");
-const errors_1 = require("./errors");
-const utils_1 = require("./utils");
-/**
- * Extract a human-readable message from a viem contract error, falling back
- * to the raw message if no structured reason is available.
- */
-function wrapViemError(error, context) {
-    if (error instanceof errors_1.ContractError)
-        return error;
-    if (error instanceof Error) {
-        const e = error;
-        const cause = e['cause'];
-        const reason = cause?.['reason'] ?? cause?.['message'] ?? e['shortMessage'] ?? error.message;
-        const details = e['details'] ?? cause?.['details'];
-        const suffix = details ? ` (${details})` : '';
-        return new errors_1.ContractError(`${context}: ${reason}${suffix}`);
-    }
-    return new errors_1.ContractError(`${context}: ${String(error)}`);
-}
-const DEFAULT_REMUNERATE_GAS_LIMIT = 8000000n;
-const DEFAULT_PAY_TAB_ERC20_GAS_LIMIT = 300000n;
-const DEFAULT_MAX_FEE_PER_GAS = (0, viem_1.parseGwei)('0.1');
-const DEFAULT_MAX_PRIORITY_FEE_PER_GAS = (0, viem_1.parseGwei)('0.1');
-const DEFAULT_RECEIPT_TIMEOUT_MS = 60_000;
-const DEFAULT_RECEIPT_POLLING_INTERVAL_MS = 2_000;
-function sleep(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
-class ContractGateway {
-    publicClient;
-    walletClient;
-    contract;
-    erc20Cache = new Map();
-    txQueue = Promise.resolve();
-    constructor(publicClient, walletClient, contract) {
-        this.publicClient = publicClient;
-        this.walletClient = walletClient;
-        this.contract = contract;
-    }
-    static async create(rpcUrl, signer, contractAddress, chainId) {
-        const chain = (0, chain_1.getChain)(chainId, rpcUrl);
-        const publicClient = (0, viem_1.createPublicClient)({
-            transport: (0, viem_1.http)(rpcUrl),
-            pollingInterval: 2_000,
-        });
-        const rpcChainId = await publicClient.getChainId();
-        if (rpcChainId !== Number(chainId)) {
-            throw new errors_1.ContractError(`Connected to chain ${rpcChainId}, expected ${chainId}`);
-        }
-        const walletClient = (0, viem_1.createWalletClient)({
-            transport: (0, viem_1.http)(rpcUrl),
-            account: signer,
-            chain,
-        });
-        const contract = (0, viem_1.getContract)({
-            address: contractAddress,
-            abi: core4mica_1.core4micaAbi,
-            client: {
-                public: publicClient,
-                wallet: walletClient,
-            },
-        });
-        return new ContractGateway(publicClient, walletClient, contract);
-    }
-    erc20(token) {
-        if (!this.erc20Cache.has(token)) {
-            this.erc20Cache.set(token, (0, viem_1.getContract)({
-                address: token,
-                abi: viem_1.erc20Abi,
-                client: { public: this.publicClient, wallet: this.walletClient },
-            }));
-        }
-        return this.erc20Cache.get(token);
-    }
-    enqueueTx(fn) {
-        // Serialize transaction submissions to avoid nonce collisions.
-        const run = this.txQueue.then(fn, fn);
-        this.txQueue = run.then(() => undefined, () => undefined);
-        return run;
-    }
-    defaultFeeParams() {
-        return {
-            maxFeePerGas: DEFAULT_MAX_FEE_PER_GAS,
-            maxPriorityFeePerGas: DEFAULT_MAX_PRIORITY_FEE_PER_GAS,
-        };
-    }
-    splitWaitOptions(waitOptions) {
-        if (!waitOptions) {
-            return { receipt: { timeout: DEFAULT_RECEIPT_TIMEOUT_MS } };
-        }
-        const { gas, timeout, pollingInterval } = waitOptions;
-        return {
-            gas,
-            receipt: {
-                ...(timeout !== undefined ? { timeout } : {}),
-                ...(pollingInterval !== undefined ? { pollingInterval } : {}),
-            },
-        };
-    }
-    async getGuaranteeDomain() {
-        return this.contract.read.guaranteeDomainSeparator();
-    }
-    async getGuaranteeVersionConfig(version) {
-        const [, domainSeparator, decoder, enabled] = await this.contract.read.getGuaranteeVersionConfig([BigInt(version)]);
-        return { domainSeparator: domainSeparator, decoder: decoder, enabled };
-    }
-    async approveErc20(token, amount, waitOptions) {
-        const { receipt } = this.splitWaitOptions(waitOptions);
-        const erc20 = this.erc20(token);
-        const spender = this.contract.address;
-        const targetAllowance = (0, utils_1.parseU256)(amount);
-        const account = this.walletClient.account;
-        if (account) {
-            const currentAllowance = (await erc20.read.allowance([
-                account.address,
-                spender,
-            ]));
-            if (currentAllowance >= targetAllowance) {
-                return undefined;
-            }
-        }
-        const sendApprove = async (value) => {
-            const hash = await this.enqueueTx(() => erc20.write.approve([spender, value], this.defaultFeeParams()));
-            const txReceipt = await this.publicClient.waitForTransactionReceipt({ hash, ...receipt });
-            if (txReceipt.status !== 'success') {
-                throw new errors_1.ContractError(`approve transaction reverted: ${hash}`);
-            }
-            return txReceipt;
-        };
-        let txReceipt;
-        try {
-            txReceipt = await sendApprove(targetAllowance);
-        }
-        catch (error) {
-            // Some ERC20s (e.g. USDT) require resetting allowance to zero before
-            // setting a new non-zero value.
-            if (targetAllowance === 0n) {
-                throw wrapViemError(error, 'ERC20 approve failed');
-            }
-            try {
-                await sendApprove(0n);
-                txReceipt = await sendApprove(targetAllowance);
-            }
-            catch (retryError) {
-                throw wrapViemError(retryError, 'ERC20 approve failed after allowance reset');
-            }
-        }
-        if (account) {
-            const actual = await this.waitForErc20Allowance(erc20, account.address, spender, targetAllowance, receipt);
-            if (actual < targetAllowance) {
-                throw new errors_1.ContractError(`ERC20 allowance verification failed: on-chain allowance is ${actual} but expected ${targetAllowance}. ` +
-                    `Try calling approveErc20 again.`);
-            }
-        }
-        return txReceipt;
-    }
-    async waitForErc20Allowance(erc20, owner, spender, targetAllowance, receiptOptions) {
-        const timeout = receiptOptions.timeout ?? DEFAULT_RECEIPT_TIMEOUT_MS;
-        const pollingInterval = receiptOptions.pollingInterval ?? DEFAULT_RECEIPT_POLLING_INTERVAL_MS;
-        const deadline = Date.now() + timeout;
-        let actual = 0n;
-        while (Date.now() <= deadline) {
-            actual = (await erc20.read.allowance([owner, spender]));
-            if (actual >= targetAllowance) {
-                return actual;
-            }
-            await sleep(Math.min(pollingInterval, Math.max(0, deadline - Date.now())));
-        }
-        return actual;
-    }
-    async deposit(amount, erc20Token, waitOptions) {
-        const { receipt } = this.splitWaitOptions(waitOptions);
-        const parsedAmount = (0, utils_1.parseU256)(amount);
-        let hash;
-        if (erc20Token) {
-            // Pre-check allowance to surface a clear error before hitting the contract.
-            const account = this.walletClient.account;
-            if (account) {
-                const erc20 = this.erc20(erc20Token);
-                const allowance = await erc20.read.allowance([
-                    account.address,
-                    this.contract.address,
-                ]);
-                if (allowance < parsedAmount) {
-                    throw new errors_1.ContractError(`Insufficient ERC20 allowance: ${allowance} approved but ${parsedAmount} required. ` +
-                        `Call approveErc20("${erc20Token}", ${parsedAmount}) before depositing.`);
-                }
-            }
-            try {
-                hash = await this.enqueueTx(() => this.contract.write.depositStablecoin([erc20Token, parsedAmount], this.defaultFeeParams()));
-            }
-            catch (error) {
-                throw wrapViemError(error, 'depositStablecoin failed');
-            }
-        }
-        else {
-            try {
-                hash = await this.enqueueTx(() => this.contract.write.deposit({ value: parsedAmount, ...this.defaultFeeParams() }));
-            }
-            catch (error) {
-                throw wrapViemError(error, 'deposit failed');
-            }
-        }
-        return this.publicClient.waitForTransactionReceipt({ hash, ...receipt });
-    }
-    async getUserAssets(opts) {
-        const account = this.walletClient.account;
-        if (!account) {
-            throw new errors_1.ContractError('wallet client has no account configured');
-        }
-        const addr = account.address;
-        const result = await this.contract.read.getUserAllAssets([addr], opts);
-        return result.map((a) => ({
-            asset: a.asset,
-            collateral: a.collateral,
-            withdrawalRequestTimestamp: a.withdrawalRequestTimestamp,
-            withdrawalRequestAmount: a.withdrawalRequestAmount,
-        }));
-    }
-    async getPaymentStatus(tabId) {
-        const [paid, remunerated, asset] = await this.contract.read.getPaymentStatus([
-            (0, utils_1.parseU256)(tabId),
-        ]);
-        return {
-            paid,
-            remunerated,
-            asset,
-        };
-    }
-    async payTabEth(tabId, reqId, amount, recipient, waitOptions) {
-        const { receipt } = this.splitWaitOptions(waitOptions);
-        const data = new TextEncoder().encode(`tab_id:${tabId.toString(16)};req_id:${reqId.toString(16)}`);
-        const hash = await this.enqueueTx(() => this.walletClient.sendTransaction({
-            to: recipient,
-            value: (0, utils_1.parseU256)(amount),
-            data: (0, utils_1.hexFromBytes)(data),
-            ...this.defaultFeeParams(),
-        }));
-        return this.publicClient.waitForTransactionReceipt({ hash, ...receipt });
-    }
-    async payTabErc20(tabId, amount, erc20Token, recipient, waitOptions) {
-        const { gas, receipt } = this.splitWaitOptions(waitOptions);
-        const parsedAmount = (0, utils_1.parseU256)(amount);
-        // payTabInERC20Token uses safeTransferFrom, so the contract must be an
-        // approved spender. Auto-approve if the current allowance is insufficient.
-        await this.approveErc20(erc20Token, parsedAmount, waitOptions);
-        const hash = await this.enqueueTx(() => this.contract.write.payTabInERC20Token([(0, utils_1.parseU256)(tabId), erc20Token, parsedAmount, recipient], {
-            gas: gas ?? DEFAULT_PAY_TAB_ERC20_GAS_LIMIT,
-            ...this.defaultFeeParams(),
-        }));
-        return this.publicClient.waitForTransactionReceipt({ hash, ...receipt });
-    }
-    async requestWithdrawal(amount, erc20Token, waitOptions) {
-        const { receipt } = this.splitWaitOptions(waitOptions);
-        const value = (0, utils_1.parseU256)(amount);
-        let hash;
-        if (erc20Token) {
-            hash = await this.enqueueTx(() => this.contract.write.requestWithdrawal([erc20Token, value], this.defaultFeeParams()));
-        }
-        else {
-            hash = await this.enqueueTx(() => this.contract.write.requestWithdrawal([value], this.defaultFeeParams()));
-        }
-        return this.publicClient.waitForTransactionReceipt({ hash, ...receipt });
-    }
-    async cancelWithdrawal(erc20Token, waitOptions) {
-        const { receipt } = this.splitWaitOptions(waitOptions);
-        let hash;
-        if (erc20Token) {
-            hash = await this.enqueueTx(() => this.contract.write.cancelWithdrawal([erc20Token], this.defaultFeeParams()));
-        }
-        else {
-            hash = await this.enqueueTx(() => this.contract.write.cancelWithdrawal(this.defaultFeeParams()));
-        }
-        return this.publicClient.waitForTransactionReceipt({ hash, ...receipt });
-    }
-    async finalizeWithdrawal(erc20Token, waitOptions) {
-        const { receipt } = this.splitWaitOptions(waitOptions);
-        let hash;
-        if (erc20Token) {
-            hash = await this.enqueueTx(() => this.contract.write.finalizeWithdrawal([erc20Token], this.defaultFeeParams()));
-        }
-        else {
-            hash = await this.enqueueTx(() => this.contract.write.finalizeWithdrawal(this.defaultFeeParams()));
-        }
-        return this.publicClient.waitForTransactionReceipt({ hash, ...receipt });
-    }
-    async remunerate(claimsBlob, signatureWords, waitOptions) {
-        const { gas, receipt } = this.splitWaitOptions(waitOptions);
-        const sigStruct = {
-            x_c0_a: (0, utils_1.hexFromBytes)(signatureWords[0]),
-            x_c0_b: (0, utils_1.hexFromBytes)(signatureWords[1]),
-            x_c1_a: (0, utils_1.hexFromBytes)(signatureWords[2]),
-            x_c1_b: (0, utils_1.hexFromBytes)(signatureWords[3]),
-            y_c0_a: (0, utils_1.hexFromBytes)(signatureWords[4]),
-            y_c0_b: (0, utils_1.hexFromBytes)(signatureWords[5]),
-            y_c1_a: (0, utils_1.hexFromBytes)(signatureWords[6]),
-            y_c1_b: (0, utils_1.hexFromBytes)(signatureWords[7]),
-        };
-        const hash = await this.enqueueTx(() => this.contract.write.remunerate([(0, utils_1.hexFromBytes)(claimsBlob), sigStruct], {
-            gas: gas ?? DEFAULT_REMUNERATE_GAS_LIMIT,
-            ...this.defaultFeeParams(),
-        }));
-        return this.publicClient.waitForTransactionReceipt({ hash, ...receipt });
-    }
-}
-exports.ContractGateway = ContractGateway;

package/dist/src/debug.d.ts

@@ -1,2 +0,0 @@
-export declare const DEBUG_BLS: boolean;
-export declare const DEBUG_CERTS: boolean;

package/dist/src/debug.js

@@ -1,5 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEBUG_CERTS = exports.DEBUG_BLS = void 0;
-exports.DEBUG_BLS = process.env.DEBUG_BLS === '1';
-exports.DEBUG_CERTS = process.env.DEBUG_CERTS === '1';

package/dist/src/errors.d.ts

@@ -1,58 +0,0 @@
-/** Base class for all 4Mica SDK errors. Sets `error.name` to the subclass name. */
-export declare class FourMicaError extends Error {
-    constructor(message: string);
-}
-/** Thrown when the SDK configuration is invalid (e.g. missing required fields or bad URL). */
-export declare class ConfigError extends FourMicaError {
-}
-/** Thrown when a 4Mica core RPC call fails. Includes the HTTP status and raw response body. */
-export declare class RpcError extends FourMicaError {
-    readonly status?: number;
-    readonly body?: unknown;
-    constructor(message: string, options?: {
-        status?: number;
-        body?: unknown;
-    });
-}
-/** Thrown when the SDK client fails to initialise (e.g. chain ID mismatch). */
-export declare class ClientInitializationError extends FourMicaError {
-}
-/** Thrown when signing a payment claim fails (e.g. unsupported scheme, address mismatch). */
-export declare class SigningError extends FourMicaError {
-}
-/** Thrown when an on-chain contract call fails or returns an unexpected result. */
-export declare class ContractError extends FourMicaError {
-}
-/** Thrown when BLS certificate verification fails (e.g. domain mismatch, invalid encoding). */
-export declare class VerificationError extends FourMicaError {
-}
-/** Thrown when an x402 HTTP payment flow encounters an error. */
-export declare class X402Error extends FourMicaError {
-}
-/** Base class for authentication-related errors. */
-export declare class AuthError extends FourMicaError {
-}
-/** Thrown when the auth URL is invalid or unreachable. */
-export declare class AuthUrlError extends AuthError {
-}
-/** Thrown when a network-level error occurs during authentication. */
-export declare class AuthTransportError extends AuthError {
-}
-/** Thrown when the auth server response cannot be decoded. */
-export declare class AuthDecodeError extends AuthError {
-}
-/** Thrown when the auth server returns an error response. Includes HTTP status and body. */
-export declare class AuthApiError extends AuthError {
-    readonly status?: number;
-    readonly body?: unknown;
-    constructor(message: string, options?: {
-        status?: number;
-        body?: unknown;
-    });
-}
-/** Thrown when auth configuration is invalid. */
-export declare class AuthConfigError extends AuthError {
-}
-/** Thrown when an authenticated operation is attempted without auth being configured. */
-export declare class AuthMissingConfigError extends AuthConfigError {
-}