@remitmd/sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 remit-md
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,250 @@
+# remit.md TypeScript SDK
+
+Universal payment protocol for AI agents — TypeScript/Node.js client library.
+
+[![CI](https://github.com/remit-md/sdk/actions/workflows/ci.yml/badge.svg)](https://github.com/remit-md/sdk/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/@remitmd/sdk)](https://www.npmjs.com/package/@remitmd/sdk)
+
+## Installation
+
+```bash
+npm install @remitmd/sdk
+# or
+pnpm add @remitmd/sdk
+```
+
+## Quickstart
+
+```typescript
+import { Wallet } from "@remitmd/sdk";
+
+// From environment variables (REMITMD_KEY, REMITMD_CHAIN)
+const wallet = Wallet.fromEnv();
+
+// Or with explicit key
+const wallet = new Wallet({ privateKey: "0x...", chain: "base-sepolia" });
+
+// Get contract addresses (cached per session)
+const contracts = await wallet.getContracts();
+
+// Sign a permit (gasless USDC approval) and pay
+const permit = await wallet.signPermit(contracts.router, 1.50);
+const tx = await wallet.payDirect("0xRecipient...", 1.50, "inference fee", { permit });
+console.log(tx.txHash);
+```
+
+## Payment Models
+
+### Permits (Gasless USDC Approval)
+
+Every payment that moves USDC requires on-chain approval. Use `signPermit()` to sign an EIP-2612 permit off-chain — no gas, no approve transaction.
+
+```typescript
+const contracts = await wallet.getContracts();
+
+// signPermit(spender, amount, deadline?) — auto-fetches nonce from chain
+const permit = await wallet.signPermit(contracts.router, 5.0);
+```
+
+The `spender` must match the contract handling the payment:
+- Direct payment: `contracts.router`
+- Escrow: `contracts.escrow`
+- Tab: `contracts.tab`
+- Stream: `contracts.stream`
+- Bounty: `contracts.bounty`
+- Deposit: `contracts.deposit`
+
+### Direct Payment
+
+```typescript
+const permit = await wallet.signPermit(contracts.router, 5.0);
+const tx = await wallet.payDirect("0xRecipient...", 5.0, "AI task", { permit });
+```
+
+### Escrow
+
+```typescript
+const permit = await wallet.signPermit(contracts.escrow, 100.0);
+const escrow = await wallet.pay({
+  to: "0xContractor...",
+  amount: 100.0,
+  memo: "Code review",
+}, { permit });
+
+// Work happens...
+await wallet.releaseEscrow(escrow.id);  // pay the contractor
+// or
+await wallet.cancelEscrow(escrow.id);   // refund yourself
+```
+
+### Metered Tab (off-chain billing)
+
+```typescript
+const permit = await wallet.signPermit(contracts.tab, 50);
+const tab = await wallet.openTab({
+  to: "0xProvider...",
+  limit: 50,
+  perUnit: 0.003,
+  permit,
+});
+
+// Provider debits the tab for each API call — zero gas, instant
+
+// One on-chain settlement when done
+await wallet.closeTab(tab.id);
+```
+
+### Payment Stream
+
+```typescript
+const permit = await wallet.signPermit(contracts.stream, 10);
+const stream = await wallet.openStream({
+  to: "0xWorker...",
+  rate: 0.001, // USDC per second
+  permit,
+});
+
+await wallet.closeStream(stream.id);
+```
+
+### Bounty
+
+```typescript
+const permit = await wallet.signPermit(contracts.bounty, 25);
+const bounty = await wallet.postBounty({
+  amount: 25,
+  task: "Summarise top 10 EIPs of 2025",
+  deadline: 1700000000,
+  permit,
+});
+
+// Any agent can submit work; you decide the winner
+await wallet.awardBounty(bounty.id, "0xWinner...");
+```
+
+### Security Deposit
+
+```typescript
+const permit = await wallet.signPermit(contracts.deposit, 100);
+const deposit = await wallet.placeDeposit({
+  to: "0xCounterpart...",
+  amount: 100,
+  expires: 86400, // 24 hours
+  permit,
+});
+```
+
+## Testing with MockRemit
+
+MockRemit gives you a zero-network, zero-latency test double. No API key needed.
+
+```typescript
+import { MockRemit } from "@remitmd/sdk/testing";
+
+const mock = new MockRemit();
+const wallet = mock.wallet("0xAgent...");
+
+const tx = await wallet.payDirect("0xProvider...", 0.003);
+console.log(mock.wasPaid("0xProvider...", 0.003)); // true
+```
+
+## All Methods
+
+```typescript
+// Contract discovery (cached per session)
+wallet.getContracts()                                    // Promise<ContractAddresses>
+
+// Permits (gasless USDC approval)
+wallet.signPermit(spender, amount, deadline?)            // Promise<PermitSignature>
+wallet.signUsdcPermit({ spender, value, deadline, ... }) // Promise<PermitSignature>
+
+// Direct payment
+wallet.payDirect(to, amount, memo?, { permit? })         // Promise<Transaction>
+
+// Escrow
+wallet.pay(invoice, { permit? })                         // Promise<Escrow>
+wallet.claimStart(invoiceId)                             // Promise<Transaction>
+wallet.submitEvidence(invoiceId, uri, milestoneIndex?)   // Promise<Transaction>
+wallet.releaseEscrow(invoiceId)                          // Promise<Transaction>
+wallet.releaseMilestone(invoiceId, index)                // Promise<Transaction>
+wallet.cancelEscrow(invoiceId)                           // Promise<Transaction>
+wallet.getEscrow(invoiceId)                              // Promise<Escrow>
+
+// Tabs
+wallet.openTab({ to, limit, perUnit, expires?, permit? })    // Promise<Tab>
+wallet.closeTab(tabId)                                       // Promise<Transaction>
+wallet.getTab(tabId)                                         // Promise<Tab>
+
+// Streams
+wallet.openStream({ to, rate, maxDuration?, maxTotal?, permit? }) // Promise<Stream>
+wallet.closeStream(streamId)                                      // Promise<Transaction>
+
+// Bounties
+wallet.postBounty({ amount, task, deadline, permit?, ... })  // Promise<Bounty>
+wallet.submitBounty(bountyId, evidenceUri)                   // Promise<Transaction>
+wallet.awardBounty(bountyId, winner)                         // Promise<Transaction>
+
+// Deposits
+wallet.placeDeposit({ to, amount, expires, permit? })    // Promise<Deposit>
+
+// Status & analytics
+wallet.status()                                          // Promise<WalletStatus>
+wallet.balance()                                         // Promise<number>
+
+// Webhooks
+wallet.registerWebhook(url, events, chains?)             // Promise<Webhook>
+wallet.listWebhooks()                                    // Promise<Webhook[]>
+wallet.deleteWebhook(id)                                 // Promise<void>
+
+// Operator links
+wallet.createFundLink()                                  // Promise<LinkResponse>
+wallet.createWithdrawLink()                              // Promise<LinkResponse>
+
+// Testnet
+wallet.mint(amount)                                      // Promise<{ tx_hash, balance }>
+wallet.requestTestnetFunds()                             // Promise<Transaction> (deprecated)
+
+// x402 (HTTP 402 auto-pay)
+wallet.x402Fetch(url, maxAutoPayUsdc?, init?)            // Promise<Response>
+```
+
+## x402 Support
+
+The SDK has built-in support for the x402 HTTP payment protocol:
+
+```typescript
+// Auto-pay any 402 response up to 0.10 USDC
+const response = await wallet.x402Fetch("https://api.example.com/data", 0.10);
+const data = await response.json();
+```
+
+## Error Handling
+
+All errors are structured with machine-readable codes and enriched details:
+
+```typescript
+try {
+  await wallet.payDirect("0xRecipient...", 100.0);
+} catch (err) {
+  if (err instanceof RemitError) {
+    console.log(err.code);    // "INSUFFICIENT_BALANCE"
+    console.log(err.message); // "Insufficient USDC balance: have $5.00, need $100.00"
+    // Enriched errors include actual numbers in details:
+    // err.details = {required: "100.00", available: "5.00",
+    //               required_units: 100000000, available_units: 5000000}
+  }
+}
+```
+
+## Chains
+
+```typescript
+new Wallet({ privateKey: key, chain: "base" })          // Base mainnet (default)
+new Wallet({ privateKey: key, chain: "base-sepolia" })   // Base Sepolia testnet
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE)
+
+[Documentation](https://remit.md/docs) · [Protocol Spec](https://remit.md) · [GitHub](https://github.com/remit-md/sdk)

package/dist/a2a.d.ts

@@ -0,0 +1,137 @@
+/**
+ * A2A / AP2 — agent card discovery and A2A JSON-RPC task client.
+ *
+ * Spec: https://google.github.io/A2A/specification/
+ * AP2:  https://ap2-protocol.org/
+ */
+import type { Signer } from "./signer.js";
+export interface A2AExtension {
+    uri: string;
+    description: string;
+    required: boolean;
+}
+export interface A2ACapabilities {
+    streaming: boolean;
+    pushNotifications: boolean;
+    stateTransitionHistory: boolean;
+    extensions: A2AExtension[];
+}
+export interface A2ASkill {
+    id: string;
+    name: string;
+    description: string;
+    tags: string[];
+}
+export interface A2AFees {
+    standardBps: number;
+    preferredBps: number;
+    cliffUsd: number;
+}
+export interface A2AX402 {
+    settleEndpoint: string;
+    assets: Record<string, string>;
+    fees: A2AFees;
+}
+export interface AgentCard {
+    protocolVersion: string;
+    name: string;
+    description: string;
+    /** A2A JSON-RPC endpoint URL (POST). */
+    url: string;
+    version: string;
+    documentationUrl: string;
+    capabilities: A2ACapabilities;
+    authentication: unknown[];
+    skills: A2ASkill[];
+    x402: A2AX402;
+}
+/**
+ * Fetch and parse the A2A agent card from `baseUrl`/.well-known/agent-card.json.
+ *
+ * @example
+ * ```ts
+ * const card = await discoverAgent("https://remit.md");
+ * console.log(card.name, card.url);
+ * ```
+ */
+export declare function discoverAgent(baseUrl: string): Promise<AgentCard>;
+export interface A2ATaskStatus {
+    state: "completed" | "failed" | "canceled" | "working" | string;
+    message?: {
+        text?: string;
+    };
+}
+export interface A2AArtifactPart {
+    kind: string;
+    data?: Record<string, unknown>;
+}
+export interface A2AArtifact {
+    name?: string;
+    parts: A2AArtifactPart[];
+}
+export interface A2ATask {
+    id: string;
+    status: A2ATaskStatus;
+    artifacts: A2AArtifact[];
+}
+/** Extract `txHash` from task artifacts, if present. */
+export declare function getTaskTxHash(task: A2ATask): string | undefined;
+export interface IntentMandate {
+    mandateId: string;
+    expiresAt: string;
+    issuer: string;
+    allowance: {
+        maxAmount: string;
+        currency: string;
+    };
+}
+export interface A2AClientOptions {
+    /** Full A2A endpoint URL from the agent card (e.g. ``"https://remit.md/a2a"``). */
+    endpoint: string;
+    signer: Signer;
+    chainId: number;
+    verifyingContract?: string;
+}
+export interface SendOptions {
+    to: string;
+    amount: number;
+    memo?: string;
+    mandate?: IntentMandate;
+}
+/**
+ * A2A JSON-RPC client — send payments and manage tasks via the A2A protocol.
+ *
+ * @example
+ * ```ts
+ * import { discoverAgent, A2AClient } from "@remitmd/sdk";
+ * import { PrivateKeySigner } from "@remitmd/sdk";
+ *
+ * const card = await discoverAgent("https://remit.md");
+ * const signer = new PrivateKeySigner(process.env.REMITMD_KEY!);
+ * const client = A2AClient.fromCard(card, signer);
+ * const task = await client.send({ to: "0xRecipient...", amount: 10 });
+ * console.log(task.status.state, getTaskTxHash(task));
+ * ```
+ */
+export declare class A2AClient {
+    private readonly _http;
+    private readonly _path;
+    constructor(opts: A2AClientOptions);
+    /** Convenience constructor from an :class:`AgentCard` and a signer. */
+    static fromCard(card: AgentCard, signer: Signer, opts?: {
+        chain?: string;
+        verifyingContract?: string;
+    }): A2AClient;
+    /**
+     * Send a direct USDC payment via ``message/send``.
+     *
+     * @returns :interface:`A2ATask` with ``status.state === "completed"`` on success.
+     */
+    send(opts: SendOptions): Promise<A2ATask>;
+    /** Fetch the current state of an A2A task by ID. */
+    getTask(taskId: string): Promise<A2ATask>;
+    /** Cancel an in-progress A2A task. */
+    cancelTask(taskId: string): Promise<A2ATask>;
+    private _rpc;
+}
+//# sourceMappingURL=a2a.d.ts.map

package/dist/a2a.d.ts.map

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

package/dist/a2a.js

@@ -0,0 +1,121 @@
+/**
+ * A2A / AP2 — agent card discovery and A2A JSON-RPC task client.
+ *
+ * Spec: https://google.github.io/A2A/specification/
+ * AP2:  https://ap2-protocol.org/
+ */
+import { AuthenticatedClient } from "./http.js";
+import { CHAIN_IDS } from "./client.js";
+/**
+ * Fetch and parse the A2A agent card from `baseUrl`/.well-known/agent-card.json.
+ *
+ * @example
+ * ```ts
+ * const card = await discoverAgent("https://remit.md");
+ * console.log(card.name, card.url);
+ * ```
+ */
+export async function discoverAgent(baseUrl) {
+    const url = baseUrl.replace(/\/$/, "") + "/.well-known/agent-card.json";
+    const res = await fetch(url, { headers: { Accept: "application/json" } });
+    if (!res.ok) {
+        throw new Error(`Agent card discovery failed: HTTP ${res.status} ${res.statusText}`);
+    }
+    return (await res.json());
+}
+/** Extract `txHash` from task artifacts, if present. */
+export function getTaskTxHash(task) {
+    for (const artifact of task.artifacts) {
+        for (const part of artifact.parts) {
+            const tx = part.data?.["txHash"];
+            if (typeof tx === "string")
+                return tx;
+        }
+    }
+    return undefined;
+}
+// ─── A2A client ───────────────────────────────────────────────────────────────
+/**
+ * A2A JSON-RPC client — send payments and manage tasks via the A2A protocol.
+ *
+ * @example
+ * ```ts
+ * import { discoverAgent, A2AClient } from "@remitmd/sdk";
+ * import { PrivateKeySigner } from "@remitmd/sdk";
+ *
+ * const card = await discoverAgent("https://remit.md");
+ * const signer = new PrivateKeySigner(process.env.REMITMD_KEY!);
+ * const client = A2AClient.fromCard(card, signer);
+ * const task = await client.send({ to: "0xRecipient...", amount: 10 });
+ * console.log(task.status.state, getTaskTxHash(task));
+ * ```
+ */
+export class A2AClient {
+    _http;
+    _path;
+    constructor(opts) {
+        const { endpoint, signer, chainId, verifyingContract = "" } = opts;
+        const parsed = new URL(endpoint);
+        const baseUrl = `${parsed.protocol}//${parsed.host}`;
+        this._path = parsed.pathname || "/a2a";
+        this._http = new AuthenticatedClient({ signer, baseUrl, chainId, verifyingContract });
+    }
+    /** Convenience constructor from an :class:`AgentCard` and a signer. */
+    static fromCard(card, signer, opts) {
+        const chain = opts?.chain ?? "base";
+        const chainId = CHAIN_IDS[chain] ?? CHAIN_IDS["base"];
+        return new A2AClient({
+            endpoint: card.url,
+            signer,
+            chainId,
+            verifyingContract: opts?.verifyingContract ?? "",
+        });
+    }
+    /**
+     * Send a direct USDC payment via ``message/send``.
+     *
+     * @returns :interface:`A2ATask` with ``status.state === "completed"`` on success.
+     */
+    async send(opts) {
+        const { to, amount, memo = "", mandate } = opts;
+        const nonce = crypto.randomUUID().replace(/-/g, "");
+        const messageId = crypto.randomUUID().replace(/-/g, "");
+        const message = {
+            messageId,
+            role: "user",
+            parts: [
+                {
+                    kind: "data",
+                    data: {
+                        model: "direct",
+                        to,
+                        amount: amount.toFixed(2),
+                        memo,
+                        nonce,
+                    },
+                },
+            ],
+        };
+        if (mandate) {
+            message["metadata"] = { mandate };
+        }
+        return this._rpc("message/send", { message }, messageId);
+    }
+    /** Fetch the current state of an A2A task by ID. */
+    async getTask(taskId) {
+        return this._rpc("tasks/get", { id: taskId }, taskId.slice(0, 16));
+    }
+    /** Cancel an in-progress A2A task. */
+    async cancelTask(taskId) {
+        return this._rpc("tasks/cancel", { id: taskId }, taskId.slice(0, 16));
+    }
+    async _rpc(method, params, callId) {
+        const body = { jsonrpc: "2.0", id: callId, method, params };
+        const data = await this._http.post(this._path, body);
+        if (data.error) {
+            throw new Error(`A2A error: ${data.error.message ?? JSON.stringify(data.error)}`);
+        }
+        return (data.result ?? data);
+    }
+}
+//# sourceMappingURL=a2a.js.map

package/dist/a2a.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,41 @@
+/**
+ * RemitClient — read-only operations, no private key required.
+ */
+import type { WalletStatus, Reputation, ContractAddresses } from "./models/index.js";
+import type { Invoice } from "./models/invoice.js";
+import type { Escrow } from "./models/escrow.js";
+import type { Tab } from "./models/tab.js";
+import type { Stream } from "./models/stream.js";
+import type { Bounty } from "./models/bounty.js";
+import type { Deposit } from "./models/deposit.js";
+export declare const CHAIN_IDS: Record<string, number>;
+export interface RemitClientOptions {
+    chain?: string;
+    testnet?: boolean;
+    apiUrl?: string;
+}
+export declare class RemitClient {
+    #private;
+    protected readonly _chain: string;
+    protected readonly _apiUrl: string;
+    protected readonly _chainId: number;
+    constructor(options?: RemitClientOptions);
+    protected _fetch<T>(path: string): Promise<T>;
+    getInvoice(invoiceId: string): Promise<Invoice>;
+    getEscrow(invoiceId: string): Promise<Escrow>;
+    getTab(tabId: string): Promise<Tab>;
+    getStream(streamId: string): Promise<Stream>;
+    getBounty(bountyId: string): Promise<Bounty>;
+    getDeposit(depositId: string): Promise<Deposit>;
+    getStatus(wallet: string): Promise<WalletStatus>;
+    getReputation(wallet: string): Promise<Reputation>;
+    /** Get deployed contract addresses. Cached for the lifetime of this client instance. */
+    getContracts(): Promise<ContractAddresses>;
+    listBounties(options?: {
+        status?: string;
+        limit?: number;
+        poster?: string;
+        submitter?: string;
+    }): Promise<Bounty[]>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACrF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAOnD,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAI5C,CAAC;AAEF,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,WAAW;;IACtB,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAClC,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACnC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAGxB,OAAO,GAAE,kBAAuB;cAQ5B,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAUnD,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/C,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI7C,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAInC,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI5C,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI5C,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/C,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAIhD,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAIlD,wFAAwF;IAClF,YAAY,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAOhD,YAAY,CAAC,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAUxH"}

package/dist/client.js

@@ -0,0 +1,81 @@
+/**
+ * RemitClient — read-only operations, no private key required.
+ */
+const DEFAULT_API_URLS = {
+    base: "https://api.remit.md/api/v0",
+    "base-sepolia": "https://testnet.remit.md/api/v0",
+    localhost: "http://localhost:3000/api/v0",
+};
+export const CHAIN_IDS = {
+    base: 8453,
+    "base-sepolia": 84532,
+    localhost: 31337,
+};
+export class RemitClient {
+    _chain;
+    _apiUrl;
+    _chainId;
+    #contractsCache = null;
+    constructor(options = {}) {
+        const { chain = "base", testnet = false, apiUrl } = options;
+        this._chain = testnet && !chain.includes("sepolia") ? `${chain}-sepolia` : chain;
+        this._apiUrl =
+            apiUrl ?? DEFAULT_API_URLS[this._chain] ?? DEFAULT_API_URLS["base"];
+        this._chainId = CHAIN_IDS[this._chain] ?? CHAIN_IDS["base"];
+    }
+    async _fetch(path) {
+        const response = await fetch(`${this._apiUrl}${path}`, {
+            headers: { "Content-Type": "application/json" },
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        return (await response.json());
+    }
+    getInvoice(invoiceId) {
+        return this._fetch(`/invoices/${invoiceId}`);
+    }
+    getEscrow(invoiceId) {
+        return this._fetch(`/escrows/${invoiceId}`);
+    }
+    getTab(tabId) {
+        return this._fetch(`/tabs/${tabId}`);
+    }
+    getStream(streamId) {
+        return this._fetch(`/streams/${streamId}`);
+    }
+    getBounty(bountyId) {
+        return this._fetch(`/bounties/${bountyId}`);
+    }
+    getDeposit(depositId) {
+        return this._fetch(`/deposits/${depositId}`);
+    }
+    getStatus(wallet) {
+        return this._fetch(`/status/${wallet}`);
+    }
+    getReputation(wallet) {
+        return this._fetch(`/reputation/${wallet}`);
+    }
+    /** Get deployed contract addresses. Cached for the lifetime of this client instance. */
+    async getContracts() {
+        if (this.#contractsCache)
+            return this.#contractsCache;
+        const contracts = await this._fetch("/contracts");
+        this.#contractsCache = contracts;
+        return contracts;
+    }
+    listBounties(options = {}) {
+        const params = new URLSearchParams();
+        if (options.status)
+            params.set("status", options.status);
+        if (options.limit)
+            params.set("limit", String(options.limit));
+        if (options.poster)
+            params.set("poster", options.poster);
+        if (options.submitter)
+            params.set("submitter", options.submitter);
+        const qs = params.toString();
+        return this._fetch(`/bounties${qs ? `?${qs}` : ""}`);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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