@remitmd/sdk 0.1.0

package/dist/errors.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Typed error classes for remit.md error codes.
+ *
+ * Every API error code maps to a specific class so callers can handle precisely:
+ *
+ *   try {
+ *     await wallet.pay(invoice);
+ *   } catch (e) {
+ *     if (e instanceof InsufficientBalanceError) {
+ *       await wallet.requestTestnetFunds();
+ *     }
+ *   }
+ */
+export declare class RemitError extends Error {
+    readonly code: string;
+    readonly httpStatus: number;
+    constructor(message: string, code?: string, httpStatus?: number);
+}
+export declare class InvalidSignatureError extends RemitError {
+    constructor(msg?: string);
+}
+export declare class NonceReusedError extends RemitError {
+    constructor(msg?: string);
+}
+export declare class TimestampExpiredError extends RemitError {
+    constructor(msg?: string);
+}
+export declare class UnauthorizedError extends RemitError {
+    constructor(msg?: string);
+}
+export declare class InsufficientBalanceError extends RemitError {
+    constructor(msg?: string);
+}
+export declare class BelowMinimumError extends RemitError {
+    constructor(msg?: string);
+}
+export declare class EscrowNotFoundError extends RemitError {
+    constructor(msg?: string);
+}
+export declare class EscrowAlreadyFundedError extends RemitError {
+    constructor(msg?: string);
+}
+export declare class EscrowExpiredError extends RemitError {
+    constructor(msg?: string);
+}
+export declare class InvalidInvoiceError extends RemitError {
+    constructor(msg?: string);
+}
+export declare class DuplicateInvoiceError extends RemitError {
+    constructor(msg?: string);
+}
+export declare class SelfPaymentError extends RemitError {
+    constructor(msg?: string);
+}
+export declare class InvalidPaymentTypeError extends RemitError {
+    constructor(msg?: string);
+}
+export declare class TabDepletedError extends RemitError {
+    constructor(msg?: string);
+}
+export declare class TabExpiredError extends RemitError {
+    constructor(msg?: string);
+}
+export declare class TabNotFoundError extends RemitError {
+    constructor(msg?: string);
+}
+export declare class StreamNotFoundError extends RemitError {
+    constructor(msg?: string);
+}
+export declare class RateExceedsCapError extends RemitError {
+    constructor(msg?: string);
+}
+export declare class BountyExpiredError extends RemitError {
+    constructor(msg?: string);
+}
+export declare class BountyClaimedError extends RemitError {
+    constructor(msg?: string);
+}
+export declare class BountyMaxAttemptsError extends RemitError {
+    constructor(msg?: string);
+}
+export declare class BountyNotFoundError extends RemitError {
+    constructor(msg?: string);
+}
+export declare class ChainMismatchError extends RemitError {
+    constructor(msg?: string);
+}
+export declare class ChainUnsupportedError extends RemitError {
+    constructor(msg?: string);
+}
+export declare class RateLimitedError extends RemitError {
+    constructor(msg?: string);
+}
+export declare class CancelBlockedClaimStartError extends RemitError {
+    constructor(msg?: string);
+}
+export declare class CancelBlockedEvidenceError extends RemitError {
+    constructor(msg?: string);
+}
+export declare class VersionMismatchError extends RemitError {
+    constructor(msg?: string);
+}
+export declare class NetworkError extends RemitError {
+    constructor(msg?: string);
+}
+/** Map an API error code + message into the appropriate typed error. */
+export declare function fromErrorCode(code: string, message?: string): RemitError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,OAAO,EAAE,MAAM,EAAE,IAAI,SAAkB,EAAE,UAAU,SAAM;CAMtE;AAID,qBAAa,qBAAsB,SAAQ,UAAU;gBACvC,GAAG,SAA+B;CAG/C;AAED,qBAAa,gBAAiB,SAAQ,UAAU;gBAClC,GAAG,SAAiC;CAGjD;AAED,qBAAa,qBAAsB,SAAQ,UAAU;gBACvC,GAAG,SAAmC;CAGnD;AAED,qBAAa,iBAAkB,SAAQ,UAAU;gBACnC,GAAG,SAA6B;CAG7C;AAID,qBAAa,wBAAyB,SAAQ,UAAU;gBAC1C,GAAG,SAAiE;CAGjF;AAED,qBAAa,iBAAkB,SAAQ,UAAU;gBACnC,GAAG,SAA+C;CAG/D;AAID,qBAAa,mBAAoB,SAAQ,UAAU;gBACrC,GAAG,SAAsB;CAGtC;AAED,qBAAa,wBAAyB,SAAQ,UAAU;gBAC1C,GAAG,SAA8C;CAG9D;AAED,qBAAa,kBAAmB,SAAQ,UAAU;gBACpC,GAAG,SAAwB;CAGxC;AAID,qBAAa,mBAAoB,SAAQ,UAAU;gBACrC,GAAG,SAAqC;CAGrD;AAED,qBAAa,qBAAsB,SAAQ,UAAU;gBACvC,GAAG,SAA4C;CAG5D;AAED,qBAAa,gBAAiB,SAAQ,UAAU;gBAClC,GAAG,SAAyB;CAGzC;AAED,qBAAa,uBAAwB,SAAQ,UAAU;gBACzC,GAAG,SAAgD;CAGhE;AAID,qBAAa,gBAAiB,SAAQ,UAAU;gBAClC,GAAG,SAAwC;CAGxD;AAED,qBAAa,eAAgB,SAAQ,UAAU;gBACjC,GAAG,SAAqB;CAGrC;AAED,qBAAa,gBAAiB,SAAQ,UAAU;gBAClC,GAAG,SAAmB;CAGnC;AAID,qBAAa,mBAAoB,SAAQ,UAAU;gBACrC,GAAG,SAAsB;CAGtC;AAED,qBAAa,mBAAoB,SAAQ,UAAU;gBACrC,GAAG,SAAgD;CAGhE;AAID,qBAAa,kBAAmB,SAAQ,UAAU;gBACpC,GAAG,SAAwB;CAGxC;AAED,qBAAa,kBAAmB,SAAQ,UAAU;gBACpC,GAAG,SAAqC;CAGrD;AAED,qBAAa,sBAAuB,SAAQ,UAAU;gBACxC,GAAG,SAAoD;CAGpE;AAED,qBAAa,mBAAoB,SAAQ,UAAU;gBACrC,GAAG,SAAsB;CAGtC;AAID,qBAAa,kBAAmB,SAAQ,UAAU;gBACpC,GAAG,SAA+C;CAG/D;AAED,qBAAa,qBAAsB,SAAQ,UAAU;gBACvC,GAAG,SAAiC;CAGjD;AAID,qBAAa,gBAAiB,SAAQ,UAAU;gBAClC,GAAG,SAA0C;CAG1D;AAID,qBAAa,4BAA6B,SAAQ,UAAU;gBAC9C,GAAG,SAAqC;CAGrD;AAED,qBAAa,0BAA2B,SAAQ,UAAU;gBAC5C,GAAG,SAAoD;CAGpE;AAID,qBAAa,oBAAqB,SAAQ,UAAU;gBACtC,GAAG,SAAyD;CAGzE;AAED,qBAAa,YAAa,SAAQ,UAAU;gBAC9B,GAAG,SAA4B;CAG5C;AAmCD,wEAAwE;AACxE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,CAIxE"}

package/dist/errors.js

@@ -0,0 +1,218 @@
+/**
+ * Typed error classes for remit.md error codes.
+ *
+ * Every API error code maps to a specific class so callers can handle precisely:
+ *
+ *   try {
+ *     await wallet.pay(invoice);
+ *   } catch (e) {
+ *     if (e instanceof InsufficientBalanceError) {
+ *       await wallet.requestTestnetFunds();
+ *     }
+ *   }
+ */
+export class RemitError extends Error {
+    code;
+    httpStatus;
+    constructor(message, code = "UNKNOWN_ERROR", httpStatus = 500) {
+        super(message);
+        this.name = this.constructor.name;
+        this.code = code;
+        this.httpStatus = httpStatus;
+    }
+}
+// ─── Auth errors ─────────────────────────────────────────────────────────────
+export class InvalidSignatureError extends RemitError {
+    constructor(msg = "Invalid EIP-712 signature.") {
+        super(msg, "INVALID_SIGNATURE", 401);
+    }
+}
+export class NonceReusedError extends RemitError {
+    constructor(msg = "Nonce has already been used.") {
+        super(msg, "NONCE_REUSED", 401);
+    }
+}
+export class TimestampExpiredError extends RemitError {
+    constructor(msg = "Request timestamp has expired.") {
+        super(msg, "TIMESTAMP_EXPIRED", 401);
+    }
+}
+export class UnauthorizedError extends RemitError {
+    constructor(msg = "Authentication required.") {
+        super(msg, "UNAUTHORIZED", 401);
+    }
+}
+// ─── Balance / funds ──────────────────────────────────────────────────────────
+export class InsufficientBalanceError extends RemitError {
+    constructor(msg = "Wallet does not have enough USDC for this transaction + fee.") {
+        super(msg, "INSUFFICIENT_BALANCE", 402);
+    }
+}
+export class BelowMinimumError extends RemitError {
+    constructor(msg = "Transaction amount is below $0.01 minimum.") {
+        super(msg, "BELOW_MINIMUM", 400);
+    }
+}
+// ─── Escrow errors ────────────────────────────────────────────────────────────
+export class EscrowNotFoundError extends RemitError {
+    constructor(msg = "Escrow not found.") {
+        super(msg, "ESCROW_NOT_FOUND", 404);
+    }
+}
+export class EscrowAlreadyFundedError extends RemitError {
+    constructor(msg = "This invoice already has a funded escrow.") {
+        super(msg, "ESCROW_ALREADY_FUNDED", 409);
+    }
+}
+export class EscrowExpiredError extends RemitError {
+    constructor(msg = "Escrow has expired.") {
+        super(msg, "ESCROW_EXPIRED", 410);
+    }
+}
+// ─── Invoice errors ───────────────────────────────────────────────────────────
+export class InvalidInvoiceError extends RemitError {
+    constructor(msg = "Invoice is malformed or invalid.") {
+        super(msg, "INVALID_INVOICE", 400);
+    }
+}
+export class DuplicateInvoiceError extends RemitError {
+    constructor(msg = "An invoice with this ID already exists.") {
+        super(msg, "DUPLICATE_INVOICE", 409);
+    }
+}
+export class SelfPaymentError extends RemitError {
+    constructor(msg = "Cannot pay yourself.") {
+        super(msg, "SELF_PAYMENT", 400);
+    }
+}
+export class InvalidPaymentTypeError extends RemitError {
+    constructor(msg = "Payment type is not valid for this invoice.") {
+        super(msg, "INVALID_PAYMENT_TYPE", 400);
+    }
+}
+// ─── Tab errors ───────────────────────────────────────────────────────────────
+export class TabDepletedError extends RemitError {
+    constructor(msg = "Tab has reached its spending limit.") {
+        super(msg, "TAB_DEPLETED", 402);
+    }
+}
+export class TabExpiredError extends RemitError {
+    constructor(msg = "Tab has expired.") {
+        super(msg, "TAB_EXPIRED", 410);
+    }
+}
+export class TabNotFoundError extends RemitError {
+    constructor(msg = "Tab not found.") {
+        super(msg, "TAB_NOT_FOUND", 404);
+    }
+}
+// ─── Stream errors ────────────────────────────────────────────────────────────
+export class StreamNotFoundError extends RemitError {
+    constructor(msg = "Stream not found.") {
+        super(msg, "STREAM_NOT_FOUND", 404);
+    }
+}
+export class RateExceedsCapError extends RemitError {
+    constructor(msg = "Streaming rate exceeds the maximum allowed.") {
+        super(msg, "RATE_EXCEEDS_CAP", 422);
+    }
+}
+// ─── Bounty errors ────────────────────────────────────────────────────────────
+export class BountyExpiredError extends RemitError {
+    constructor(msg = "Bounty has expired.") {
+        super(msg, "BOUNTY_EXPIRED", 410);
+    }
+}
+export class BountyClaimedError extends RemitError {
+    constructor(msg = "Bounty has already been awarded.") {
+        super(msg, "BOUNTY_CLAIMED", 409);
+    }
+}
+export class BountyMaxAttemptsError extends RemitError {
+    constructor(msg = "Bounty has reached maximum submission attempts.") {
+        super(msg, "BOUNTY_MAX_ATTEMPTS", 422);
+    }
+}
+export class BountyNotFoundError extends RemitError {
+    constructor(msg = "Bounty not found.") {
+        super(msg, "BOUNTY_NOT_FOUND", 404);
+    }
+}
+// ─── Chain errors ─────────────────────────────────────────────────────────────
+export class ChainMismatchError extends RemitError {
+    constructor(msg = "Invoice chain does not match wallet chain.") {
+        super(msg, "CHAIN_MISMATCH", 409);
+    }
+}
+export class ChainUnsupportedError extends RemitError {
+    constructor(msg = "This chain is not supported.") {
+        super(msg, "CHAIN_UNSUPPORTED", 422);
+    }
+}
+// ─── Rate limiting ────────────────────────────────────────────────────────────
+export class RateLimitedError extends RemitError {
+    constructor(msg = "Rate limit exceeded. Try again later.") {
+        super(msg, "RATE_LIMITED", 429);
+    }
+}
+// ─── Cancellation errors ──────────────────────────────────────────────────────
+export class CancelBlockedClaimStartError extends RemitError {
+    constructor(msg = "Cannot cancel after claim start.") {
+        super(msg, "CANCEL_BLOCKED_CLAIM_START", 409);
+    }
+}
+export class CancelBlockedEvidenceError extends RemitError {
+    constructor(msg = "Cannot cancel while evidence is pending review.") {
+        super(msg, "CANCEL_BLOCKED_EVIDENCE", 409);
+    }
+}
+// ─── Protocol errors ──────────────────────────────────────────────────────────
+export class VersionMismatchError extends RemitError {
+    constructor(msg = "SDK version is not compatible with this API version.") {
+        super(msg, "VERSION_MISMATCH", 422);
+    }
+}
+export class NetworkError extends RemitError {
+    constructor(msg = "Network request failed.") {
+        super(msg, "NETWORK_ERROR", 503);
+    }
+}
+// ─── Factory ──────────────────────────────────────────────────────────────────
+const ERROR_MAP = {
+    INVALID_SIGNATURE: InvalidSignatureError,
+    NONCE_REUSED: NonceReusedError,
+    TIMESTAMP_EXPIRED: TimestampExpiredError,
+    UNAUTHORIZED: UnauthorizedError,
+    INSUFFICIENT_BALANCE: InsufficientBalanceError,
+    BELOW_MINIMUM: BelowMinimumError,
+    ESCROW_NOT_FOUND: EscrowNotFoundError,
+    ESCROW_ALREADY_FUNDED: EscrowAlreadyFundedError,
+    ESCROW_EXPIRED: EscrowExpiredError,
+    INVALID_INVOICE: InvalidInvoiceError,
+    DUPLICATE_INVOICE: DuplicateInvoiceError,
+    SELF_PAYMENT: SelfPaymentError,
+    INVALID_PAYMENT_TYPE: InvalidPaymentTypeError,
+    TAB_DEPLETED: TabDepletedError,
+    TAB_EXPIRED: TabExpiredError,
+    TAB_NOT_FOUND: TabNotFoundError,
+    STREAM_NOT_FOUND: StreamNotFoundError,
+    RATE_EXCEEDS_CAP: RateExceedsCapError,
+    BOUNTY_EXPIRED: BountyExpiredError,
+    BOUNTY_CLAIMED: BountyClaimedError,
+    BOUNTY_MAX_ATTEMPTS: BountyMaxAttemptsError,
+    BOUNTY_NOT_FOUND: BountyNotFoundError,
+    CHAIN_MISMATCH: ChainMismatchError,
+    CHAIN_UNSUPPORTED: ChainUnsupportedError,
+    RATE_LIMITED: RateLimitedError,
+    CANCEL_BLOCKED_CLAIM_START: CancelBlockedClaimStartError,
+    CANCEL_BLOCKED_EVIDENCE: CancelBlockedEvidenceError,
+    VERSION_MISMATCH: VersionMismatchError,
+};
+/** Map an API error code + message into the appropriate typed error. */
+export function fromErrorCode(code, message) {
+    const Cls = ERROR_MAP[code];
+    if (Cls)
+        return new Cls(message);
+    return new RemitError(message ?? `Unknown error: ${code}`, code);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/http.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Authenticated HTTP client.
+ * - Signs every request with EIP-712 (method, path, timestamp, nonce)
+ * - Auto-retry with exponential backoff on 429 and 5xx (up to 3 retries)
+ * - Adds idempotency key header on all POST/PATCH/PUT requests
+ * - Maps API error codes to typed RemitError subclasses
+ */
+import type { Signer } from "./signer.js";
+export interface HttpClientOptions {
+    signer: Signer;
+    baseUrl: string;
+    chainId: number;
+    verifyingContract?: string;
+}
+export declare class AuthenticatedClient {
+    #private;
+    constructor({ signer, baseUrl, chainId, verifyingContract }: HttpClientOptions);
+    get<T>(path: string): Promise<T>;
+    post<T>(path: string, body?: unknown): Promise<T>;
+    put<T>(path: string, body?: unknown): Promise<T>;
+    delete<T>(path: string): Promise<T>;
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAsD1C,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,qBAAa,mBAAmB;;gBAUlB,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,iBAAsB,EAAE,EAAE,iBAAiB;IAU7E,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAIhC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAIjD,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAIhD,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CAsF1C"}

package/dist/http.js

@@ -0,0 +1,150 @@
+/**
+ * Authenticated HTTP client.
+ * - Signs every request with EIP-712 (method, path, timestamp, nonce)
+ * - Auto-retry with exponential backoff on 429 and 5xx (up to 3 retries)
+ * - Adds idempotency key header on all POST/PATCH/PUT requests
+ * - Maps API error codes to typed RemitError subclasses
+ */
+import { randomBytes } from "node:crypto";
+import { fromErrorCode, NetworkError, RateLimitedError } from "./errors.js";
+// EIP-712 typed struct definition — must match server's auth.rs exactly.
+// Struct name: APIRequest (not Request)
+// Timestamp type: uint256 (not uint64 or uint32)
+// Nonce type: bytes32 (not string)
+const EIP712_TYPES = {
+    APIRequest: [
+        { name: "method", type: "string" },
+        { name: "path", type: "string" },
+        { name: "timestamp", type: "uint256" },
+        { name: "nonce", type: "bytes32" },
+    ],
+};
+/** 32-byte hex nonce with 0x prefix — required for bytes32 EIP-712 field. */
+function newNonce() {
+    return `0x${randomBytes(32).toString("hex")}`;
+}
+function newIdempotencyKey() {
+    return randomBytes(16).toString("hex");
+}
+/** Convert a snake_case key to camelCase (e.g. "tx_hash" → "txHash"). */
+function toCamel(key) {
+    return key.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+}
+/** Recursively transform all object keys from snake_case to camelCase.
+ *  The server (Rust/serde) emits snake_case; TypeScript SDK uses camelCase. */
+function camelizeKeys(value) {
+    if (Array.isArray(value))
+        return value.map(camelizeKeys);
+    if (value !== null && typeof value === "object") {
+        return Object.fromEntries(Object.entries(value).map(([k, v]) => [toCamel(k), camelizeKeys(v)]));
+    }
+    return value;
+}
+const RETRYABLE = new Set([429, 500, 502, 503, 504]);
+const DELAY_MS = [200, 600, 1800]; // exponential-ish
+async function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export class AuthenticatedClient {
+    #signer;
+    #baseUrl;
+    #chainId;
+    #verifyingContract;
+    /** Path prefix extracted from baseUrl (e.g. "/api/v0") to prepend when signing.
+     *  The server verifies the full path (/api/v0/payments/direct) via OriginalUri,
+     *  not just the relative segment (/payments/direct). */
+    #signPathPrefix;
+    constructor({ signer, baseUrl, chainId, verifyingContract = "" }) {
+        this.#signer = signer;
+        this.#baseUrl = baseUrl.replace(/\/$/, "");
+        this.#chainId = chainId;
+        this.#verifyingContract = verifyingContract;
+        // Parse path prefix from baseUrl so signed path matches OriginalUri on server.
+        const parsedUrl = new URL(this.#baseUrl);
+        this.#signPathPrefix = parsedUrl.pathname.replace(/\/$/, "");
+    }
+    async get(path) {
+        return this.#request("GET", path);
+    }
+    async post(path, body) {
+        return this.#request("POST", path, body);
+    }
+    async put(path, body) {
+        return this.#request("PUT", path, body);
+    }
+    async delete(path) {
+        return this.#request("DELETE", path);
+    }
+    async #request(method, path, body, attempt = 0) {
+        const timestamp = Math.floor(Date.now() / 1000);
+        const nonce = newNonce();
+        const domain = {
+            name: "remit.md",
+            version: "0.1",
+            chainId: this.#chainId,
+            verifyingContract: this.#verifyingContract,
+        };
+        // Sign the full path (prefix + relative path only, no query string) so it matches
+        // the path OriginalUri on the server. The server verifies only the path component.
+        // e.g. baseUrl "http://…/api/v0" + path "/events?wallet=0x…" → signed "/api/v0/events"
+        const pathOnly = path.split("?")[0];
+        const signedPath = `${this.#signPathPrefix}${pathOnly}`;
+        // Sign the request metadata (never body — body may be large)
+        const signature = await this.#signer.signTypedData(domain, 
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        EIP712_TYPES, { method, path: signedPath, timestamp: BigInt(timestamp), nonce });
+        const headers = {
+            "Content-Type": "application/json",
+            "X-Remit-Agent": this.#signer.getAddress(),
+            "X-Remit-Signature": signature,
+            "X-Remit-Timestamp": String(timestamp),
+            "X-Remit-Nonce": nonce,
+        };
+        if (method === "POST" || method === "PUT" || method === "PATCH") {
+            headers["X-Idempotency-Key"] = newIdempotencyKey();
+        }
+        let response;
+        try {
+            response = await fetch(`${this.#baseUrl}${path}`, {
+                method,
+                headers,
+                body: body !== undefined ? JSON.stringify(body) : undefined,
+            });
+        }
+        catch (err) {
+            throw new NetworkError(`Network request failed: ${String(err)}`);
+        }
+        if (response.ok) {
+            if (response.status === 204)
+                return undefined;
+            return camelizeKeys(await response.json());
+        }
+        // Retryable errors
+        if (RETRYABLE.has(response.status) && attempt < DELAY_MS.length) {
+            if (response.status === 429) {
+                // Respect Retry-After header if present
+                const retryAfter = response.headers.get("Retry-After");
+                const delay = retryAfter ? parseInt(retryAfter) * 1000 : DELAY_MS[attempt];
+                await sleep(delay);
+            }
+            else {
+                await sleep(DELAY_MS[attempt]);
+            }
+            return this.#request(method, path, body, attempt + 1);
+        }
+        // Parse error body
+        let errorBody = {};
+        try {
+            errorBody = (await response.json());
+        }
+        catch {
+            // ignore parse failures
+        }
+        const code = errorBody.error?.code ?? errorBody.code ?? `HTTP_${response.status}`;
+        const message = errorBody.error?.message ?? errorBody.message ?? response.statusText;
+        if (response.status === 429)
+            throw new RateLimitedError(message);
+        throw fromErrorCode(code, message);
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG5E,yEAAyE;AACzE,wCAAwC;AACxC,iDAAiD;AACjD,mCAAmC;AACnC,MAAM,YAAY,GAAG;IACnB,UAAU,EAAE;QACV,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE;QAClC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;QAChC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;QACtC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;KACnC;CACO,CAAC;AAQX,6EAA6E;AAC7E,SAAS,QAAQ;IACf,OAAO,KAAK,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;AAChD,CAAC;AAED,SAAS,iBAAiB;IACxB,OAAO,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC;AAED,yEAAyE;AACzE,SAAS,OAAO,CAAC,GAAW;IAC1B,OAAO,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AACrE,CAAC;AAED;+EAC+E;AAC/E,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACzD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CACrE,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AACrD,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,kBAAkB;AAErD,KAAK,UAAU,KAAK,CAAC,EAAU;IAC7B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AASD,MAAM,OAAO,mBAAmB;IACrB,OAAO,CAAS;IAChB,QAAQ,CAAS;IACjB,QAAQ,CAAS;IACjB,kBAAkB,CAAS;IACpC;;4DAEwD;IAC/C,eAAe,CAAS;IAEjC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,iBAAiB,GAAG,EAAE,EAAqB;QACjF,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,kBAAkB,GAAG,iBAAiB,CAAC;QAC5C,+EAA+E;QAC/E,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,IAAY;QACvB,OAAO,IAAI,CAAC,QAAQ,CAAI,KAAK,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,IAAI,CAAI,IAAY,EAAE,IAAc;QACxC,OAAO,IAAI,CAAC,QAAQ,CAAI,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,IAAY,EAAE,IAAc;QACvC,OAAO,IAAI,CAAC,QAAQ,CAAI,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,MAAM,CAAI,IAAY;QAC1B,OAAO,IAAI,CAAC,QAAQ,CAAI,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,QAAQ,CAAI,MAAc,EAAE,IAAY,EAAE,IAAc,EAAE,OAAO,GAAG,CAAC;QACzE,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;QAEzB,MAAM,MAAM,GAAG;YACb,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,IAAI,CAAC,QAAQ;YACtB,iBAAiB,EAAE,IAAI,CAAC,kBAAkB;SAC3C,CAAC;QAEF,kFAAkF;QAClF,mFAAmF;QACnF,uFAAuF;QACvF,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,UAAU,GAAG,GAAG,IAAI,CAAC,eAAe,GAAG,QAAQ,EAAE,CAAC;QAExD,6DAA6D;QAC7D,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAChD,MAAM;QACN,8DAA8D;QAC9D,YAAmB,EACnB,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAClE,CAAC;QAEF,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;YAClC,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE;YAC1C,mBAAmB,EAAE,SAAS;YAC9B,mBAAmB,EAAE,MAAM,CAAC,SAAS,CAAC;YACtC,eAAe,EAAE,KAAK;SACvB,CAAC;QAEF,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YAChE,OAAO,CAAC,mBAAmB,CAAC,GAAG,iBAAiB,EAAE,CAAC;QACrD,CAAC;QAED,IAAI,QAAkB,CAAC;QACvB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,QAAQ,GAAG,IAAI,EAAE,EAAE;gBAChD,MAAM;gBACN,OAAO;gBACP,IAAI,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;aAC5D,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,YAAY,CAAC,2BAA2B,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnE,CAAC;QAED,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;YAChB,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;gBAAE,OAAO,SAAc,CAAC;YACnD,OAAO,YAAY,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAM,CAAC;QAClD,CAAC;QAED,mBAAmB;QACnB,IAAI,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,OAAO,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC;YAChE,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,wCAAwC;gBACxC,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;gBACvD,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAC3E,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC;iBAAM,CAAC;gBACN,MAAM,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;YACjC,CAAC;YACD,OAAO,IAAI,CAAC,QAAQ,CAAI,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;QAC3D,CAAC;QAED,mBAAmB;QACnB,IAAI,SAAS,GAAiB,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,SAAS,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAiB,CAAC;QACtD,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;QAED,MAAM,IAAI,GACR,SAAS,CAAC,KAAK,EAAE,IAAI,IAAI,SAAS,CAAC,IAAI,IAAI,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC;QACvE,MAAM,OAAO,GACX,SAAS,CAAC,KAAK,EAAE,OAAO,IAAI,SAAS,CAAC,OAAO,IAAI,QAAQ,CAAC,UAAU,CAAC;QAEvE,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;YAAE,MAAM,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACjE,MAAM,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export { discoverAgent, A2AClient, getTaskTxHash, } from "./a2a.js";
+export type { AgentCard, A2ACapabilities, A2AExtension, A2ASkill, A2AX402, A2AFees, A2ATask, A2ATaskStatus, A2AArtifact, A2AArtifactPart, IntentMandate, SendOptions, A2AClientOptions, } from "./a2a.js";
+export { RemitClient } from "./client.js";
+export { Wallet } from "./wallet.js";
+export type { WalletOptions, OpenTabOptions, CloseTabOptions, ChargeTabOptions, OpenStreamOptions, PostBountyOptions, PlaceDepositOptions, PermitSignature, SignPermitOptions, } from "./wallet.js";
+export { PrivateKeySigner } from "./signer.js";
+export type { Signer, TypedDataDomain, TypedDataTypes } from "./signer.js";
+export { RemitError, fromErrorCode, InvalidSignatureError, NonceReusedError, TimestampExpiredError, UnauthorizedError, InsufficientBalanceError, BelowMinimumError, EscrowNotFoundError, EscrowAlreadyFundedError, EscrowExpiredError, InvalidInvoiceError, DuplicateInvoiceError, SelfPaymentError, InvalidPaymentTypeError, TabDepletedError, TabExpiredError, TabNotFoundError, StreamNotFoundError, RateExceedsCapError, BountyExpiredError, BountyClaimedError, BountyMaxAttemptsError, BountyNotFoundError, ChainMismatchError, ChainUnsupportedError, RateLimitedError, CancelBlockedClaimStartError, CancelBlockedEvidenceError, VersionMismatchError, NetworkError, } from "./errors.js";
+export * from "./models/index.js";
+export { MockRemit, MockWallet } from "./testing/mock.js";
+export { LocalChain } from "./testing/local.js";
+export { X402Client, AllowanceExceededError } from "./x402.js";
+export type { X402ClientOptions } from "./x402.js";
+export { X402Paywall } from "./provider.js";
+export type { PaywallOptions, CheckResult } from "./provider.js";
+export { remitTools } from "./integrations/vercel-ai.js";
+export type { RemitToolDescriptor } from "./integrations/vercel-ai.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":"AACA,OAAO,EACL,aAAa,EACb,SAAS,EACT,aAAa,GACd,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,SAAS,EACT,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,OAAO,EACP,OAAO,EACP,aAAa,EACb,WAAW,EACX,eAAe,EACf,aAAa,EACb,WAAW,EACX,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EACV,aAAa,EACb,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG3E,OAAO,EACL,UAAU,EACV,aAAa,EACb,qBAAqB,EACrB,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,wBAAwB,EACxB,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,uBAAuB,EACvB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,4BAA4B,EAC5B,0BAA0B,EAC1B,oBAAoB,EACpB,YAAY,GACb,MAAM,aAAa,CAAC;AAGrB,cAAc,mBAAmB,CAAC;AAGlC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAC/D,YAAY,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAGnD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGjE,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,YAAY,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+// A2A / AP2
+export { discoverAgent, A2AClient, getTaskTxHash, } from "./a2a.js";
+// Core classes
+export { RemitClient } from "./client.js";
+export { Wallet } from "./wallet.js";
+// Signers
+export { PrivateKeySigner } from "./signer.js";
+// Errors
+export { RemitError, fromErrorCode, InvalidSignatureError, NonceReusedError, TimestampExpiredError, UnauthorizedError, InsufficientBalanceError, BelowMinimumError, EscrowNotFoundError, EscrowAlreadyFundedError, EscrowExpiredError, InvalidInvoiceError, DuplicateInvoiceError, SelfPaymentError, InvalidPaymentTypeError, TabDepletedError, TabExpiredError, TabNotFoundError, StreamNotFoundError, RateExceedsCapError, BountyExpiredError, BountyClaimedError, BountyMaxAttemptsError, BountyNotFoundError, ChainMismatchError, ChainUnsupportedError, RateLimitedError, CancelBlockedClaimStartError, CancelBlockedEvidenceError, VersionMismatchError, NetworkError, } from "./errors.js";
+// Models
+export * from "./models/index.js";
+// Testing utilities
+export { MockRemit, MockWallet } from "./testing/mock.js";
+export { LocalChain } from "./testing/local.js";
+// x402 client middleware
+export { X402Client, AllowanceExceededError } from "./x402.js";
+// x402 provider middleware
+export { X402Paywall } from "./provider.js";
+// Integrations
+export { remitTools } from "./integrations/vercel-ai.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,YAAY;AACZ,OAAO,EACL,aAAa,EACb,SAAS,EACT,aAAa,GACd,MAAM,UAAU,CAAC;AAiBlB,eAAe;AACf,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAarC,UAAU;AACV,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/C,SAAS;AACT,OAAO,EACL,UAAU,EACV,aAAa,EACb,qBAAqB,EACrB,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,wBAAwB,EACxB,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,uBAAuB,EACvB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,4BAA4B,EAC5B,0BAA0B,EAC1B,oBAAoB,EACpB,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,SAAS;AACT,cAAc,mBAAmB,CAAC;AAElC,oBAAoB;AACpB,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,yBAAyB;AACzB,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAG/D,2BAA2B;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,eAAe;AACf,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/integrations/vercel-ai.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Vercel AI SDK integration for remit.md.
+ *
+ * Usage with the Vercel AI SDK:
+ *
+ *   import { generateText } from "ai";
+ *   import { anthropic } from "@ai-sdk/anthropic";
+ *   import { Wallet } from "@remitmd/sdk";
+ *   import { remitTools } from "@remitmd/sdk/integrations/vercel-ai";
+ *
+ *   const wallet = Wallet.fromEnv();
+ *   const result = await generateText({
+ *     model: anthropic("claude-opus-4-6"),
+ *     tools: remitTools(wallet),
+ *     prompt: "Pay agent@example.com $5 for the data analysis.",
+ *   });
+ *
+ * Note: This module exports plain tool descriptors compatible with the AI SDK tool()
+ * format. Import `tool` from "ai" and `z` from "zod" in your application — we don't
+ * bundle them to avoid version conflicts.
+ */
+import type { Wallet } from "../wallet.js";
+/** Parameter schema for a remit tool (zod-compatible shape description). */
+interface ToolParam {
+    type: "string" | "number" | "boolean";
+    description: string;
+    optional?: boolean;
+}
+/** Lightweight tool descriptor — compatible with Vercel AI SDK `tool()` format. */
+export interface RemitToolDescriptor {
+    description: string;
+    parameters: Record<string, ToolParam>;
+    execute: (...args: unknown[]) => Promise<unknown>;
+}
+/**
+ * Returns remit.md payment tools configured for the given wallet.
+ * Pass the result directly as the `tools` parameter to `generateText` / `streamText`.
+ *
+ * Compatible with Vercel AI SDK v3+. Each entry is a plain object with
+ * `description`, `parameters`, and `execute` — wrap with `tool()` from "ai" if needed.
+ */
+export declare function remitTools(wallet: Wallet): Record<string, RemitToolDescriptor>;
+export {};
+//# sourceMappingURL=vercel-ai.d.ts.map

package/dist/integrations/vercel-ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel-ai.d.ts","sourceRoot":"","sources":["../../src/integrations/vercel-ai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,4EAA4E;AAC5E,UAAU,SAAS;IACjB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,mFAAmF;AACnF,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACtC,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACnD;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAuK9E"}