@4mica/sdk 1.2.17 → 1.3.1

package/dist/src/bls.js

@@ -1,247 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.signatureToWords = signatureToWords;
-exports.signatureToWordsAsync = signatureToWordsAsync;
-const viem_1 = require("viem");
-const debug_1 = require("./debug");
-const errors_1 = require("./errors");
-let curvesCache = null;
-let curvesPromise = null;
-function splitFp(value) {
-    const be48 = value.toString(16).padStart(96, '0');
-    const bytes = (0, viem_1.toBytes)(`0x${be48}`);
-    const hi = new Uint8Array(32);
-    hi.set(bytes.slice(0, 16), 16);
-    const lo = bytes.slice(16);
-    return [hi, lo];
-}
-const normalizeBlsImportError = (err) => {
-    const message = err instanceof Error ? err.message : String(err);
-    if (message.includes('ERR_PACKAGE_PATH_NOT_EXPORTED')) {
-        return new errors_1.VerificationError('BLS decoding requires @noble/curves; use the .js subpath (bls12-381.js) or update the SDK.');
-    }
-    if (message.includes('ERR_REQUIRE_ESM') || message.includes('require() of ES Module')) {
-        return new errors_1.VerificationError('BLS decoding requires @noble/curves; ESM install detected. Use signatureToWordsAsync or run in CJS.');
-    }
-    return new errors_1.VerificationError('BLS decoding requires @noble/curves; install it to enable remuneration');
-};
-const loadCurvesSync = () => {
-    if (curvesCache)
-        return curvesCache;
-    try {
-        // Lazy require to keep the dependency optional.
-        // eslint-disable-next-line @typescript-eslint/no-require-imports
-        curvesCache = require('@noble/curves/bls12-381');
-        return curvesCache;
-    }
-    catch {
-        try {
-            // eslint-disable-next-line @typescript-eslint/no-require-imports
-            curvesCache = require('@noble/curves/bls12-381.js');
-            return curvesCache;
-        }
-        catch (err2) {
-            throw normalizeBlsImportError(err2);
-        }
-    }
-};
-const isBlsModule = (mod) => mod !== null &&
-    typeof mod === 'object' &&
-    'bls12_381' in mod &&
-    typeof mod.bls12_381 === 'object';
-const loadCurvesAsync = async () => {
-    if (curvesCache)
-        return curvesCache;
-    if (curvesPromise)
-        return curvesPromise;
-    curvesPromise = (async () => {
-        try {
-            // Try CJS first.
-            // eslint-disable-next-line @typescript-eslint/no-require-imports
-            return require('@noble/curves/bls12-381');
-        }
-        catch {
-            const mod = await Promise.resolve().then(() => __importStar(require('@noble/curves/bls12-381.js')));
-            if (!isBlsModule(mod)) {
-                throw new errors_1.VerificationError('BLS decoding: unexpected module shape from @noble/curves');
-            }
-            return mod;
-        }
-    })();
-    curvesCache = await curvesPromise;
-    return curvesCache;
-};
-const normalizeSignature = (input) => {
-    if (debug_1.DEBUG_BLS) {
-        const type = input && typeof input === 'object'
-            ? `object(keys=${Object.keys(input)
-                .slice(0, 6)
-                .join(',')})`
-            : typeof input;
-        console.log(`  debug bls: normalizeSignature input=${type}`);
-    }
-    if (typeof input === 'string') {
-        const raw = input.startsWith('0x') ? input.slice(2) : input;
-        const bytes = (0, viem_1.toBytes)(`0x${raw}`);
-        return { hex: raw, bytes };
-    }
-    if (input instanceof Uint8Array) {
-        const hex = Buffer.from(input).toString('hex');
-        return { hex, bytes: input };
-    }
-    if (typeof Buffer !== 'undefined' && Buffer.isBuffer(input)) {
-        const hex = input.toString('hex');
-        return { hex, bytes: new Uint8Array(input) };
-    }
-    if (input instanceof ArrayBuffer) {
-        const bytes = new Uint8Array(input);
-        const hex = Buffer.from(bytes).toString('hex');
-        return { hex, bytes };
-    }
-    if (ArrayBuffer.isView(input)) {
-        const bytes = new Uint8Array(input.buffer, input.byteOffset, input.byteLength);
-        const hex = Buffer.from(bytes).toString('hex');
-        return { hex, bytes };
-    }
-    if (Array.isArray(input)) {
-        const bytes = Uint8Array.from(input);
-        const hex = Buffer.from(bytes).toString('hex');
-        return { hex, bytes };
-    }
-    if (input && typeof input === 'object') {
-        const record = input;
-        if (Array.isArray(record.data)) {
-            const arr = record.data;
-            if (arr.some((b) => typeof b !== 'number' || b < 0 || b > 255 || !Number.isInteger(b))) {
-                throw new errors_1.VerificationError('signature data array contains invalid byte values');
-            }
-            const bytes = Uint8Array.from(arr);
-            const hex = Buffer.from(bytes).toString('hex');
-            return { hex, bytes };
-        }
-        if ('bytes' in record) {
-            return normalizeSignature(record.bytes);
-        }
-        if ('signature' in record) {
-            return normalizeSignature(record.signature);
-        }
-    }
-    const label = input && typeof input === 'object'
-        ? `object(keys=${Object.keys(input)
-            .slice(0, 6)
-            .join(',')})`
-        : typeof input;
-    throw new errors_1.VerificationError(`expected signature hex string or bytes, got ${label}`);
-};
-const signatureToWordsWith = (curves, signatureHex) => {
-    const toBigint = (field) => {
-        if (typeof field === 'bigint' || typeof field === 'number' || typeof field === 'string') {
-            return BigInt(field);
-        }
-        if (field && typeof field === 'object' && 'value' in field && field.value !== undefined) {
-            const value = field.value;
-            if (typeof value === 'bigint' || typeof value === 'number' || typeof value === 'string') {
-                return BigInt(value);
-            }
-        }
-        throw new errors_1.VerificationError('invalid BLS field element');
-    };
-    const readFp2 = (value) => {
-        if (!value || typeof value !== 'object') {
-            throw new errors_1.VerificationError('invalid BLS field element');
-        }
-        const record = value;
-        if (Array.isArray(record.c) && record.c.length >= 2) {
-            return [record.c[0], record.c[1]];
-        }
-        if ('c0' in record && 'c1' in record) {
-            return [record.c0, record.c1];
-        }
-        if (Array.isArray(record.coeffs)) {
-            const coeffs = record.coeffs;
-            if (coeffs.length >= 2)
-                return [coeffs[0], coeffs[1]];
-        }
-        throw new errors_1.VerificationError('invalid BLS field element');
-    };
-    try {
-        const sig = normalizeSignature(signatureHex);
-        const g2 = curves.bls12_381.G2;
-        const pointCtor = g2.Point ?? g2.ProjectivePoint;
-        if (!pointCtor?.fromHex) {
-            throw new errors_1.VerificationError('unsupported @noble/curves BLS export');
-        }
-        let point;
-        try {
-            point = pointCtor.fromHex(sig.bytes);
-        }
-        catch (err) {
-            const message = err instanceof Error ? err.message : String(err);
-            if (message.includes('hex string expected')) {
-                point = pointCtor.fromHex(sig.hex);
-            }
-            else {
-                throw err;
-            }
-        }
-        const affine = point.toAffine();
-        const [x0, x1] = readFp2(affine.x);
-        const [y0, y1] = readFp2(affine.y);
-        const coords = [x0, x1, y0, y1].map((fp) => toBigint(fp));
-        const words = [];
-        coords.forEach((coord) => {
-            const [hi, lo] = splitFp(coord);
-            words.push(hi, lo);
-        });
-        return words;
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        throw new errors_1.VerificationError(`invalid BLS signature: ${message}`);
-    }
-};
-/**
- * Expand a compressed G2 signature into the tuple expected by the contract.
- * This mirrors the Python helper and requires the optional `@noble/curves` dependency.
- */
-function signatureToWords(signatureHex) {
-    const curves = loadCurvesSync();
-    return signatureToWordsWith(curves, signatureHex);
-}
-async function signatureToWordsAsync(signatureHex) {
-    const curves = await loadCurvesAsync();
-    return signatureToWordsWith(curves, signatureHex);
-}

package/dist/src/chain.d.ts

@@ -1,2 +0,0 @@
-import type { Chain } from 'viem';
-export declare function getChain(chainId: number, rpcUrl: string): Chain;

package/dist/src/chain.js

@@ -1,26 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getChain = getChain;
-const chains_1 = require("viem/chains");
-const CHAINS = {
-    1: chains_1.mainnet,
-    11155111: chains_1.sepolia,
-    8453: chains_1.base,
-    84532: chains_1.baseSepolia,
-    137: chains_1.polygon,
-    80002: chains_1.polygonAmoy,
-};
-function getChain(chainId, rpcUrl) {
-    const chain = CHAINS[chainId];
-    if (chain)
-        return chain;
-    return {
-        id: chainId,
-        name: `local-${chainId}`,
-        nativeCurrency: { name: 'Ether', symbol: 'ETH', decimals: 18 },
-        rpcUrls: {
-            default: { http: [rpcUrl] },
-            public: { http: [rpcUrl] },
-        },
-    };
-}

package/dist/src/client/index.d.ts

@@ -1,71 +0,0 @@
-import type { AuthTokens } from '../auth';
-import { Config } from '../config';
-import { ContractGateway } from '../contract';
-import { RpcProxy } from '../rpc';
-import { CorePublicParameters } from '../models';
-import { PaymentSigner } from '../signing';
-import { RecipientClient } from './recipient';
-import { UserClient } from './user';
-/**
- * Top-level SDK client. Holds a live connection to the 4Mica core RPC and the
- * on-chain Core4Mica contract. Obtain an instance via {@link Client.new}.
- *
- * @example
- * ```ts
- * const cfg = new ConfigBuilder().walletPrivateKey("0x...").build();
- * const client = await Client.new(cfg);
- * try {
- *   // client.user  – payer-side operations
- *   // client.recipient – recipient-side operations
- * } finally {
- *   await client.aclose();
- * }
- * ```
- */
-export declare class Client {
-    /** Low-level RPC proxy to the 4Mica core service. */
-    readonly rpc: RpcProxy;
-    /** Chain and contract parameters fetched from the core service at startup. */
-    readonly params: CorePublicParameters;
-    /** viem-backed gateway for on-chain calls (deposit, remunerate, …). */
-    readonly gateway: ContractGateway;
-    /** 32-byte domain separator used to verify V1 BLS guarantee certificates. */
-    readonly guaranteeDomain: string;
-    /** Payer-side operations: deposit, sign, withdraw. */
-    readonly user: UserClient;
-    /** Recipient-side operations: tabs, guarantees, remuneration. */
-    readonly recipient: RecipientClient;
-    /** Payment signing wrapper around the configured viem Account. */
-    readonly signer: PaymentSigner;
-    private authSession?;
-    private constructor();
-    /**
-     * Create and fully initialise a Client.
-     *
-     * Fetches public parameters from the core service, validates that the
-     * Ethereum RPC is on the expected chain, and sets up SIWE auth if configured.
-     *
-     * @param cfg - Validated configuration produced by {@link ConfigBuilder.build}.
-     * @throws {@link ConfigError} if the configuration is invalid.
-     * @throws {@link RpcError} if the core service is unreachable.
-     * @throws {@link ContractError} if the Ethereum RPC returns the wrong chain ID.
-     */
-    static new(cfg: Config): Promise<Client>;
-    private static buildGateway;
-    /**
-     * Release client resources. Safe to call multiple times.
-     * Use in a `finally` block to ensure cleanup after use.
-     */
-    aclose(): Promise<void>;
-    /**
-     * Perform an explicit SIWE login and return the resulting tokens.
-     *
-     * Not required for normal operation — the first authenticated RPC call
-     * triggers auth automatically. Call this to pre-warm the session.
-     *
-     * @throws {@link AuthMissingConfigError} if auth was not enabled in the config.
-     */
-    login(): Promise<AuthTokens>;
-}
-export { UserClient } from './user';
-export { RecipientClient } from './recipient';

package/dist/src/client/index.js

@@ -1,120 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RecipientClient = exports.UserClient = exports.Client = void 0;
-const auth_1 = require("../auth");
-const contract_1 = require("../contract");
-const errors_1 = require("../errors");
-const rpc_1 = require("../rpc");
-const networks_1 = require("../networks");
-const signing_1 = require("../signing");
-const recipient_1 = require("./recipient");
-const user_1 = require("./user");
-/**
- * Top-level SDK client. Holds a live connection to the 4Mica core RPC and the
- * on-chain Core4Mica contract. Obtain an instance via {@link Client.new}.
- *
- * @example
- * ```ts
- * const cfg = new ConfigBuilder().walletPrivateKey("0x...").build();
- * const client = await Client.new(cfg);
- * try {
- *   // client.user  – payer-side operations
- *   // client.recipient – recipient-side operations
- * } finally {
- *   await client.aclose();
- * }
- * ```
- */
-class Client {
-    /** Low-level RPC proxy to the 4Mica core service. */
-    rpc;
-    /** Chain and contract parameters fetched from the core service at startup. */
-    params;
-    /** viem-backed gateway for on-chain calls (deposit, remunerate, …). */
-    gateway;
-    /** 32-byte domain separator used to verify V1 BLS guarantee certificates. */
-    guaranteeDomain;
-    /** Payer-side operations: deposit, sign, withdraw. */
-    user;
-    /** Recipient-side operations: tabs, guarantees, remuneration. */
-    recipient;
-    /** Payment signing wrapper around the configured viem Account. */
-    signer;
-    authSession;
-    constructor(rpc, params, gateway, guaranteeDomain, signer, authSession) {
-        this.rpc = rpc;
-        this.params = params;
-        this.gateway = gateway;
-        this.guaranteeDomain = guaranteeDomain;
-        this.signer = signer;
-        this.authSession = authSession;
-        this.user = new user_1.UserClient(this);
-        this.recipient = new recipient_1.RecipientClient(this);
-    }
-    /**
-     * Create and fully initialise a Client.
-     *
-     * Fetches public parameters from the core service, validates that the
-     * Ethereum RPC is on the expected chain, and sets up SIWE auth if configured.
-     *
-     * @param cfg - Validated configuration produced by {@link ConfigBuilder.build}.
-     * @throws {@link ConfigError} if the configuration is invalid.
-     * @throws {@link RpcError} if the core service is unreachable.
-     * @throws {@link ContractError} if the Ethereum RPC returns the wrong chain ID.
-     */
-    static async new(cfg) {
-        const rpc = new rpc_1.RpcProxy(cfg.rpcUrl, cfg.adminApiKey);
-        const params = await rpc.getPublicParams();
-        const gateway = await Client.buildGateway(cfg, params);
-        const guaranteeDomain = await gateway.getGuaranteeDomain();
-        const signer = new signing_1.PaymentSigner(cfg.signer);
-        const authEnabled = cfg.authUrl !== undefined || cfg.authRefreshMarginSecs !== undefined;
-        const authSession = cfg.bearerToken || !authEnabled
-            ? undefined
-            : new auth_1.AuthSession({
-                authUrl: cfg.authUrl ?? cfg.rpcUrl,
-                signer: cfg.signer,
-                refreshMarginSecs: cfg.authRefreshMarginSecs ?? 60,
-            });
-        if (cfg.bearerToken) {
-            rpc.withBearerToken(cfg.bearerToken);
-        }
-        else if (authSession) {
-            rpc.withTokenProvider(() => authSession.accessToken());
-        }
-        return new Client(rpc, params, gateway, guaranteeDomain, signer, authSession);
-    }
-    static async buildGateway(cfg, params) {
-        const ethRpcUrl = cfg.ethereumHttpRpcUrl ??
-            params.ethereumHttpRpcUrl ??
-            (0, networks_1.resolvePublicRpcUrl)(`eip155:${params.chainId}`);
-        const contractAddress = cfg.contractAddress ?? params.contractAddress;
-        return contract_1.ContractGateway.create(ethRpcUrl, cfg.signer, contractAddress, params.chainId);
-    }
-    /**
-     * Release client resources. Safe to call multiple times.
-     * Use in a `finally` block to ensure cleanup after use.
-     */
-    async aclose() {
-        await this.rpc.aclose();
-    }
-    /**
-     * Perform an explicit SIWE login and return the resulting tokens.
-     *
-     * Not required for normal operation — the first authenticated RPC call
-     * triggers auth automatically. Call this to pre-warm the session.
-     *
-     * @throws {@link AuthMissingConfigError} if auth was not enabled in the config.
-     */
-    async login() {
-        if (!this.authSession) {
-            throw new errors_1.AuthMissingConfigError('auth is not enabled');
-        }
-        return this.authSession.login();
-    }
-}
-exports.Client = Client;
-var user_2 = require("./user");
-Object.defineProperty(exports, "UserClient", { enumerable: true, get: function () { return user_2.UserClient; } });
-var recipient_2 = require("./recipient");
-Object.defineProperty(exports, "RecipientClient", { enumerable: true, get: function () { return recipient_2.RecipientClient; } });

package/dist/src/client/recipient.d.ts

@@ -1,129 +0,0 @@
-import { AssetBalanceInfo, BLSCert, CollateralEventInfo, GuaranteeInfo, PaymentGuaranteeClaims, PaymentGuaranteeRequestClaims, PaymentGuaranteeRequestClaimsV2, PendingRemunerationInfo, RecipientPaymentInfo, SigningScheme, TabInfo, TabPaymentStatus } from '../models';
-import type { TxReceiptWaitOptions } from '../contract';
-import type { Client } from './index';
-/** Recipient-side operations: tab management, guarantee issuance, remuneration. */
-export declare class RecipientClient {
-    private client;
-    constructor(client: Client);
-    private get recipientAddress();
-    get guaranteeDomain(): string;
-    /**
-     * Create a payment tab via the core RPC.
-     *
-     * @param userAddress - Address of the payer.
-     * @param recipientAddress - Address of the recipient.
-     * @param erc20Token - ERC20 token address for the tab, or `null`/`undefined` for ETH.
-     * @param ttl - Optional time-to-live in seconds.
-     * @param guaranteeVersion - Guarantee version for the version-scoped tab identity.
-     * @returns `{ tabId, assetAddress, nextReqId }` — the tab ID, the asset address as stored
-     *   by the core (use this for all subsequent claims), and the first request ID to use.
-     * @throws {@link RpcError} if the request fails.
-     */
-    createTab(userAddress: string, recipientAddress: string, erc20Token: string | undefined | null, ttl?: number | null, guaranteeVersion?: number): Promise<{
-        tabId: bigint;
-        assetAddress: string;
-        nextReqId: bigint;
-    }>;
-    /**
-     * Query the on-chain payment status of a tab.
-     *
-     * @param tabId - Tab identifier.
-     * @returns `{ paid, remunerated, asset }`.
-     */
-    getTabPaymentStatus(tabId: number | bigint): Promise<TabPaymentStatus>;
-    /**
-     * Issue a BLS-signed payment guarantee certificate via the core RPC.
-     *
-     * The returned {@link BLSCert} can be stored and later passed to
-     * {@link remunerate} to claim the payment on-chain.
-     *
-     * @param claims - Signed payment claims (V1 or V2).
-     * @param signature - ECDSA signature hex string from the payer.
-     * @param scheme - Signing scheme used to produce the signature.
-     * @returns BLS certificate with ABI-encoded claims and BLS signature.
-     * @throws {@link RpcError} if the core service rejects the request.
-     */
-    issuePaymentGuarantee(claims: PaymentGuaranteeRequestClaims | PaymentGuaranteeRequestClaimsV2, signature: string, scheme: SigningScheme): Promise<BLSCert>;
-    /**
-     * Verify and decode a BLS guarantee certificate.
-     *
-     * Decodes the ABI-encoded claims and validates the domain separator against
-     * the on-chain configuration. For V2 certificates, the active V2 domain is
-     * fetched from the contract and verified to be enabled.
-     *
-     * @param cert - BLS certificate (hex-encoded claims + hex-encoded signature).
-     * @returns Decoded {@link PaymentGuaranteeClaims}, including validation policy for V2.
-     * @throws {@link VerificationError} on domain mismatch, invalid length, or disabled version.
-     */
-    verifyPaymentGuarantee(cert: BLSCert): Promise<PaymentGuaranteeClaims>;
-    /**
-     * Claim payment on-chain by submitting a verified BLS certificate.
-     *
-     * Verifies the certificate first (see {@link verifyPaymentGuarantee}), then
-     * converts the BLS signature into the G2 coordinate words expected by the
-     * contract and submits the `remunerate` transaction.
-     *
-     * Requires the optional `@noble/curves` package for BLS point decompression.
-     *
-     * @param cert - BLS certificate to settle.
-     * @param waitOptions - Optional timeout/polling overrides for receipt polling.
-     * @throws {@link VerificationError} if the certificate is invalid or `claims`/`signature`
-     *   are not hex strings.
-     * @throws {@link ContractError} if the contract call fails.
-     */
-    remunerate(cert: BLSCert, waitOptions?: TxReceiptWaitOptions): Promise<import("viem").TransactionReceipt>;
-    /** List all tabs for this recipient that have been settled on-chain. */
-    listSettledTabs(): Promise<TabInfo[]>;
-    /** List all tabs with outstanding (un-remunerated) guarantees for this recipient. */
-    listPendingRemunerations(): Promise<PendingRemunerationInfo[]>;
-    /**
-     * Fetch a single tab by ID.
-     *
-     * @param tabId - Tab identifier.
-     * @returns The tab, or `null` if not found.
-     */
-    getTab(tabId: number | bigint): Promise<TabInfo | null>;
-    /**
-     * List all tabs belonging to this recipient.
-     *
-     * @param settlementStatuses - Optional filter on settlement status (e.g. `['PENDING']`).
-     */
-    listRecipientTabs(settlementStatuses?: string[]): Promise<TabInfo[]>;
-    /**
-     * List all guarantee requests associated with a tab.
-     *
-     * @param tabId - Tab identifier.
-     */
-    getTabGuarantees(tabId: number | bigint): Promise<GuaranteeInfo[]>;
-    /**
-     * Fetch the most recent guarantee for a tab.
-     *
-     * @param tabId - Tab identifier.
-     * @returns The latest {@link GuaranteeInfo}, or `null` if none exists.
-     */
-    getLatestGuarantee(tabId: number | bigint): Promise<GuaranteeInfo | null>;
-    /**
-     * Fetch a specific guarantee by tab ID and request ID.
-     *
-     * @param tabId - Tab identifier.
-     * @param reqId - Guarantee request identifier.
-     * @returns The {@link GuaranteeInfo}, or `null` if not found.
-     */
-    getGuarantee(tabId: number | bigint, reqId: number | bigint): Promise<GuaranteeInfo | null>;
-    /** List all on-chain payments received by this recipient. */
-    listRecipientPayments(): Promise<RecipientPaymentInfo[]>;
-    /**
-     * List collateral deposit/withdrawal events associated with a tab.
-     *
-     * @param tabId - Tab identifier.
-     */
-    getCollateralEventsForTab(tabId: number | bigint): Promise<CollateralEventInfo[]>;
-    /**
-     * Fetch the collateral balance a user has locked for a specific asset.
-     *
-     * @param userAddress - Address of the payer.
-     * @param assetAddress - ERC20 token address, or zero address for ETH.
-     * @returns Balance info, or `null` if no record exists.
-     */
-    getUserAssetBalance(userAddress: string, assetAddress: string): Promise<AssetBalanceInfo | null>;
-}