@paysponge/sdk 0.1.16 → 0.1.17

package/README.md

@@ -35,6 +35,29 @@ await wallet.transfer({
 });
 ```
 
+## Generated OpenAPI Client
+
+The package also exports the raw OpenAPI Generator request builder for advanced
+REST usage:
+
+```typescript
+import {
+  HttpClient,
+  createGeneratedApiClient,
+} from "@paysponge/sdk";
+
+const http = new HttpClient({ apiKey: "sponge_test_xxx" });
+const client = createGeneratedApiClient(http);
+
+const currentAgent = await client.request<Record<string, unknown>>(
+  client.api.getApiAgentsMeRequestOpts(),
+);
+```
+
+The current backend spec is missing response schemas for most endpoints, so the
+generated layer is used for request shapes and paths while the SDK keeps its
+existing response parsing on top.
+
 ## Authentication
 
 ### Device Flow (Browser)
@@ -83,7 +106,7 @@ for await (const msg of query({
 
 ## Supported Chains
 
-- **EVM**: Ethereum, Base, Sepolia, Base Sepolia, Tempo
+- **EVM**: Ethereum, Base, Monad, Sepolia, Base Sepolia, Tempo
 - **Solana**: Mainnet, Devnet
 
 ## Features
@@ -97,31 +120,50 @@ for await (const msg of query({
 
 ## Documentation
 
-**[Early Access Docs →](./docs/index.md)**
+Canonical docs live in the repo's top-level Mintlify source:
 
-Quickstarts by use case:
-- [Self-Registration](./docs/quickstart-self-registration.md) — Create a wallet instantly, claim later
-- [AI Agents](./docs/quickstart-ai-agents.md) — Give Claude wallet tools via MCP or direct tools
-- [Platforms](./docs/quickstart-platforms.md) — Programmatic agent creation with master keys
-- [Trading & DeFi](./docs/quickstart-trading.md) — Swaps, perps, bridges, and x402 payments
+- [Welcome](https://github.com/paysponge/sponge/blob/main/docs/index.mdx)
+- [Self-Registration](https://github.com/paysponge/sponge/blob/main/docs/quickstart-self-registration.mdx)
+- [AI Agents](https://github.com/paysponge/sponge/blob/main/docs/quickstart-ai-agents.mdx)
+- [Platforms](https://github.com/paysponge/sponge/blob/main/docs/quickstart-platforms.mdx)
+- [Trading & Payments](https://github.com/paysponge/sponge/blob/main/docs/quickstart-trading.mdx)
+- [CLI](https://github.com/paysponge/sponge/blob/main/docs/cli.mdx)
+- [Authentication](https://github.com/paysponge/sponge/blob/main/docs/authentication.mdx)
+- [Wallets & Transfers](https://github.com/paysponge/sponge/blob/main/docs/wallets-and-transfers.mdx)
+- [Claude Integration](https://github.com/paysponge/sponge/blob/main/docs/claude-integration.mdx)
+- [SDK Reference](https://github.com/paysponge/sponge/blob/main/docs/sdk-reference.mdx)
+- [Master Keys](https://github.com/paysponge/sponge/blob/main/docs/master-keys.mdx)
 
-Reference:
-- [Getting Started](./docs/getting-started.md)
-- [Authentication](./docs/authentication.md)
-- [Wallets & Transfers](./docs/wallets-and-transfers.md)
-- [Claude Integration](./docs/claude-integration.md)
-- [API Reference](./docs/api-reference.md)
-- [Master Keys](./docs/master-keys.md)
+Generated-client examples:
+- [TypeScript direct OpenAPI example](./examples/openapi-generated.ts)
+- [Python generated client package](../../python/spongewallet-openapi/README.md)
 
 ## CLI
 
 ```bash
-# Login via browser
+# Create agent immediately, claim later
+npx spongewallet init
+
+# Agent-first with email for claim matching
+npx spongewallet init --email alice@example.com
+
+# Claim pending agent or do normal login if no pending claim exists
 npx spongewallet login
 
+# Curated wallet workflows
+npx spongewallet wallet balance
+npx spongewallet wallet send --chain base --to 0xabc... --amount 10 --asset USDC
+npx spongewallet tx status --chain base --tx-hash 0x123...
+
+# Raw tool commands remain available under "advanced"
+npx spongewallet advanced get-balance --chain base
+
 # Check current session
 npx spongewallet whoami
 
+# Print authenticated MCP config
+npx spongewallet mcp print
+
 # Logout
 npx spongewallet logout
 ```

package/dist/api/agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/api/agents.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,KAAK,EACV,KAAK,kBAAkB,EACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAiB5C,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;OAEG;IACG,MAAM,CACV,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAgB5C;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAO9B;;;OAGG;IACG,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAQ1C;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,KAAK,CAAC;IAOlC;;OAEG;IACG,MAAM,CACV,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACnC,OAAO,CAAC,KAAK,CAAC;IASjB;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAM7C"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/api/agents.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,KAAK,EACV,KAAK,kBAAkB,EACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAW5C,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;OAEG;IACG,MAAM,CACV,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAiB5C;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAQ9B;;;OAGG;IACG,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAQ1C;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,KAAK,CAAC;IAQlC;;OAEG;IACG,MAAM,CACV,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACnC,OAAO,CAAC,KAAK,CAAC;IAWjB;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAM7C"}

package/dist/api/agents.js

@@ -1,7 +1,6 @@
 import { z } from "zod";
 import { AgentSchema, CreateAgentOptionsSchema, } from "../types/schemas.js";
-import { deleteApiAgentsById, getApiAgents, getApiAgentsById, getApiAgentsMe, postApiAgents, putApiAgentsById, } from "./generated/heyapi/sdk.gen.js";
-import { getHeyApiClient } from "./generated/heyapi-adapter.js";
+import { createGeneratedApiClient, } from "./generated/openapi-adapter.js";
 // Response from creating an agent (includes API key)
 const CreateAgentResponseSchema = z.object({
     agent: AgentSchema,
@@ -17,11 +16,10 @@ export class AgentsApi {
      */
     async create(options) {
         const validated = CreateAgentOptionsSchema.parse(options);
-        const client = getHeyApiClient(this.http);
-        const response = await postApiAgents({
-            client,
-            body: validated,
-        });
+        const client = createGeneratedApiClient(this.http);
+        const response = await client.request(client.api.postApiAgentsRequestOpts({
+            postApiAgentsRequest: validated,
+        }));
         const parsed = CreateAgentResponseSchema.parse(response);
         return {
             agent: parsed.agent,
@@ -33,9 +31,8 @@ export class AgentsApi {
      * Note: This endpoint requires Privy auth, not API key auth
      */
     async list() {
-        const response = await getApiAgents({
-            client: getHeyApiClient(this.http),
-        });
+        const client = createGeneratedApiClient(this.http);
+        const response = await client.request(client.api.getApiAgentsRequestOpts({}));
         return z.array(AgentSchema).parse(response);
     }
     /**
@@ -43,10 +40,8 @@ export class AgentsApi {
      * Note: This endpoint requires Privy auth, not API key auth
      */
     async get(agentId) {
-        const response = await getApiAgentsById({
-            client: getHeyApiClient(this.http),
-            path: { id: agentId },
-        });
+        const client = createGeneratedApiClient(this.http);
+        const response = await client.request(client.api.getApiAgentsByIdRequestOpts({ id: agentId }));
         return AgentSchema.parse(response);
     }
     /**
@@ -54,30 +49,27 @@ export class AgentsApi {
      * This endpoint returns the agent associated with the current API key
      */
     async getCurrent() {
-        const response = await getApiAgentsMe({
-            client: getHeyApiClient(this.http),
-        });
+        const client = createGeneratedApiClient(this.http);
+        const response = await client.request(client.api.getApiAgentsMeRequestOpts());
         return AgentSchema.parse(response);
     }
     /**
      * Update an agent
      */
     async update(agentId, updates) {
-        const response = await putApiAgentsById({
-            client: getHeyApiClient(this.http),
-            path: { id: agentId },
-            body: updates,
-        });
+        const client = createGeneratedApiClient(this.http);
+        const response = await client.request(client.api.putApiAgentsByIdRequestOpts({
+            id: agentId,
+            putApiAgentsByIdRequest: updates,
+        }));
         return AgentSchema.parse(response);
     }
     /**
      * Delete an agent
      */
     async delete(agentId) {
-        await deleteApiAgentsById({
-            client: getHeyApiClient(this.http),
-            path: { id: agentId },
-        });
+        const client = createGeneratedApiClient(this.http);
+        await client.request(client.api.deleteApiAgentsByIdRequestOpts({ id: agentId }));
     }
 }
 //# sourceMappingURL=agents.js.map

package/dist/api/agents.js.map

@@ -1 +1 @@
-{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../src/api/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,WAAW,EACX,wBAAwB,GAGzB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,gBAAgB,GACjB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,qDAAqD;AACrD,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,KAAK,EAAE,WAAW;IAClB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC;AAEH,MAAM,OAAO,SAAS;IACS;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,OAA2B;QAE3B,MAAM,SAAS,GAAG,wBAAwB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE1C,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC;YACnC,MAAM;YACN,IAAI,EAAE,SAAS;SAChB,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,yBAAyB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAEzD,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,SAAS;SACzB,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI;QACR,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC;YAClC,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;SACnC,CAAC,CAAC;QACH,OAAO,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,GAAG,CAAC,OAAe;QACvB,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC;YACtC,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;YAClC,IAAI,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE;SACtB,CAAC,CAAC;QACH,OAAO,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU;QACd,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC;YACpC,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;SACnC,CAAC,CAAC;QACH,OAAO,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,OAAe,EACf,OAAoC;QAEpC,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC;YACtC,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;YAClC,IAAI,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE;YACrB,IAAI,EAAE,OAAO;SACd,CAAC,CAAC;QACH,OAAO,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,OAAe;QAC1B,MAAM,mBAAmB,CAAC;YACxB,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;YAClC,IAAI,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE;SACtB,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../src/api/agents.ts"],"names":[],"mappings":"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"}