@distilled.cloud/coinbase 0.8.0 → 0.10.0

package/lib/retry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,OAAO,EACZ,KAAK,MAAM,EACX,WAAW,EACX,QAAQ,EACR,MAAM,EACN,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;;AAE1D;;GAEG;AACH,qBAAa,KAAM,SAAQ,UAE1B;CAAG;AAEJ;;GAEG;AACH,eAAO,MAAM,MAAM,qBAAsB,MAAM,sFACS,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,IAAI,mFAEhB,CAAC"}
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,OAAO,EACZ,KAAK,MAAM,EACX,WAAW,EACX,QAAQ,EACR,MAAM,EACN,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;;AAE1D;;GAEG;AACH,qBAAa,KAAM,SAAQ,UAAiD;CAAG;AAE/E;;GAEG;AACH,eAAO,MAAM,MAAM,qBAAsB,MAAM,sFACS,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,IAAI,mFAEhB,CAAC"}

package/lib/retry.js

@@ -3,12 +3,12 @@
  */
 import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
-import * as ServiceMap from "effect/ServiceMap";
+import * as Context from "effect/Context";
 export { makeDefault, jittered, capped, throttlingOptions, transientOptions, } from "@distilled.cloud/core/retry";
 /**
  * Context tag for configuring retry behavior of Coinbase API calls.
  */
-export class Retry extends ServiceMap.Service()("CoinbaseRetry") {
+export class Retry extends Context.Service()("CoinbaseRetry") {
 }
 /**
  * Provides a custom retry policy to all Coinbase API calls.

package/lib/retry.js.map

@@ -1 +1 @@
-{"version":3,"file":"retry.js","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAIL,WAAW,EACX,QAAQ,EACR,MAAM,EACN,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AAGrC;;GAEG;AACH,MAAM,OAAO,KAAM,SAAQ,UAAU,CAAC,OAAO,EAAiB,CAC5D,eAAe,CAChB;CAAG;AAEJ;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,gBAAwB,EAAE,EAAE,CACjD,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC;AAEzD;;GAEG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAChC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,CAC7C,CAAC"}
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAIL,WAAW,EACX,QAAQ,EACR,MAAM,EACN,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AAGrC;;GAEG;AACH,MAAM,OAAO,KAAM,SAAQ,OAAO,CAAC,OAAO,EAAiB,CAAC,eAAe,CAAC;CAAG;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,gBAAwB,EAAE,EAAE,CACjD,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC;AAEzD;;GAEG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAChC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,CAC7C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@distilled.cloud/coinbase",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/alchemy-run/distilled",
@@ -73,8 +73,8 @@
     "specs:update": "git -C specs/cdp-sdk fetch && git -C specs/cdp-sdk checkout main && git -C specs/cdp-sdk pull"
   },
   "dependencies": {
-    "@distilled.cloud/core": "0.8.0",
-    "effect": "4.0.0-beta.43"
+    "@distilled.cloud/core": "0.10.0",
+    "effect": "4.0.0-beta.48"
   },
   "devDependencies": {
     "@types/bun": "^1.3.0",
@@ -84,6 +84,6 @@
     "yaml": "^2.8.2"
   },
   "peerDependencies": {
-    "effect": "4.0.0-beta.43"
+    "effect": "4.0.0-beta.48"
   }
 }

package/src/credentials.ts

@@ -1,7 +1,7 @@
 import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
 import * as Redacted from "effect/Redacted";
-import * as ServiceMap from "effect/ServiceMap";
+import * as Context from "effect/Context";
 import { ConfigError } from "@distilled.cloud/core/errors";
 
 export const DEFAULT_API_BASE_URL = "https://api.cdp.coinbase.com/platform";
@@ -32,7 +32,7 @@ export interface Config {
   readonly apiBaseUrl: string;
 }
 
-export class Credentials extends ServiceMap.Service<Credentials, Config>()(
+export class Credentials extends Context.Service<Credentials, Config>()(
   "CoinbaseCredentials",
 ) {}
 

package/src/operations/createWebhookSubscription.ts

@@ -23,6 +23,7 @@ export type CreateWebhookSubscriptionInput =
 export const CreateWebhookSubscriptionOutput =
   /*@__PURE__*/ /*#__PURE__*/ Schema.Struct({
     createdAt: Schema.String,
+    updatedAt: Schema.optional(Schema.String),
     description: Schema.optional(Schema.Struct({})),
     eventTypes: Schema.Array(Schema.String),
     isEnabled: Schema.Boolean,
@@ -62,6 +63,8 @@ export type CreateWebhookSubscriptionOutput =
  * - `payments.transfers.processing`
  * - `payments.transfers.completed`
  * - `payments.transfers.failed`
+ * - `payments.transfers.travel_rule_incomplete`
+ * - `payments.transfers.travel_rule_completed`
  * - **No labels required** - enable the transfers webhook to monitor status transitions
  * **Wallet Events** - Wallet activity notifications:
  * - `wallet.activity.detected`

package/src/operations/getSQLGrammar.ts

@@ -17,8 +17,9 @@ export type GetSQLGrammarOutput = typeof GetSQLGrammarOutput.Type;
  * Get SQL grammar
  *
  * Retrieve the SQL grammar for the SQL API.
- * The SQL queries that are supported by the SQL API are defined via an ANTLR4 grammar which is evaluated by server before executing the query. This ensures the safety and soundness of the SQL API.
- * This endpoint returns the ANTLR4 grammar that is used to evaluate the SQL queries so that developers can understand the SQL API and build SQL queries with high confidence and correctness. LLMs interact well with ANTLR4 grammar as well.
+ * The SQL queries that are supported by the SQL API are defined in ANTLR4 grammar which is evaluated by server before executing the query. This ensures the safety and soundness of the SQL query before execution.
+ * This endpoint returns the ANTLR4 grammar that is used to evaluate the SQL queries so that developers can understand the SQL API and build SQL queries with high confidence and correctness.
+ * LLMs interact well with ANTLR4 grammar. You can feed the grammar directly into the LLMs to help generate SQL queries.
  */
 export const getSQLGrammar = /*@__PURE__*/ /*#__PURE__*/ API.make(() => ({
   inputSchema: GetSQLGrammarInput,

package/src/operations/getSQLSchema.ts

@@ -0,0 +1,49 @@
+import * as Schema from "effect/Schema";
+import { API } from "../client";
+import * as T from "../traits";
+
+// Input Schema
+export const GetSQLSchemaInput = /*@__PURE__*/ /*#__PURE__*/ Schema.Struct({
+  database: Schema.optional(Schema.Literals(["base", "base_sepolia"])),
+  table: Schema.optional(Schema.String),
+}).pipe(T.Http({ method: "GET", path: "/v2/data/query/schema" }));
+export type GetSQLSchemaInput = typeof GetSQLSchemaInput.Type;
+
+// Output Schema
+export const GetSQLSchemaOutput = /*@__PURE__*/ /*#__PURE__*/ Schema.Struct({
+  tables: Schema.optional(
+    Schema.Array(
+      Schema.Struct({
+        database: Schema.optional(Schema.String),
+        table: Schema.optional(Schema.String),
+        columns: Schema.optional(
+          Schema.Array(
+            Schema.Struct({
+              name: Schema.optional(Schema.String),
+              type: Schema.optional(Schema.String),
+              nullable: Schema.optional(Schema.Boolean),
+              description: Schema.optional(Schema.Struct({})),
+              indexOrder: Schema.optional(Schema.Number),
+            }),
+          ),
+        ),
+      }),
+    ),
+  ),
+});
+export type GetSQLSchemaOutput = typeof GetSQLSchemaOutput.Type;
+
+// The operation
+/**
+ * Get schemas details
+ *
+ * Retrieve the schema information for the available tables in the SQL API's indexed data.
+ * This includes table names, column definitions, data types, and indexed fields.
+ *
+ * @param database - The name of the database to query. Defaults to "base" when not specified.
+ * @param table - Get the schema for a specific table.
+ */
+export const getSQLSchema = /*@__PURE__*/ /*#__PURE__*/ API.make(() => ({
+  inputSchema: GetSQLSchemaInput,
+  outputSchema: GetSQLSchemaOutput,
+}));

package/src/operations/getWebhookSubscription.ts

@@ -20,6 +20,7 @@ export type GetWebhookSubscriptionInput =
 export const GetWebhookSubscriptionOutput =
   /*@__PURE__*/ /*#__PURE__*/ Schema.Struct({
     createdAt: Schema.String,
+    updatedAt: Schema.optional(Schema.String),
     description: Schema.optional(Schema.Struct({})),
     eventTypes: Schema.Array(Schema.String),
     isEnabled: Schema.Boolean,

package/src/operations/index.ts

@@ -57,6 +57,7 @@ export * from "./requestSolanaFaucet";
 export * from "./listSolanaTokenBalances";
 export * from "./runSQLQuery";
 export * from "./getSQLGrammar";
+export * from "./getSQLSchema";
 export * from "./listTokensForAccount";
 export * from "./listDataTokenBalances";
 export * from "./listWebhookSubscriptions";
@@ -64,6 +65,7 @@ export * from "./createWebhookSubscription";
 export * from "./getWebhookSubscription";
 export * from "./updateWebhookSubscription";
 export * from "./deleteWebhookSubscription";
+export * from "./listWebhookSubscriptionEvents";
 export * from "./verifyX402Payment";
 export * from "./settleX402Payment";
 export * from "./supportedX402PaymentKinds";

package/src/operations/listWebhookSubscriptionEvents.ts

@@ -0,0 +1,82 @@
+import * as Schema from "effect/Schema";
+import { API } from "../client";
+import * as T from "../traits";
+
+// Input Schema
+export const ListWebhookSubscriptionEventsInput =
+  /*@__PURE__*/ /*#__PURE__*/ Schema.Struct({
+    subscriptionId: Schema.String.pipe(T.PathParam()),
+    eventId: Schema.optional(Schema.String),
+    minCreatedAt: Schema.optional(Schema.String),
+    maxCreatedAt: Schema.optional(Schema.String),
+    eventTypeNames: Schema.optional(Schema.String),
+  }).pipe(
+    T.Http({
+      method: "GET",
+      path: "/v2/data/webhooks/subscriptions/{subscriptionId}/events",
+    }),
+  );
+export type ListWebhookSubscriptionEventsInput =
+  typeof ListWebhookSubscriptionEventsInput.Type;
+
+// Output Schema
+export const ListWebhookSubscriptionEventsOutput =
+  /*@__PURE__*/ /*#__PURE__*/ Schema.Struct({
+    events: Schema.Array(
+      Schema.Struct({
+        eventId: Schema.String,
+        eventTypeName: Schema.String,
+        status: Schema.Literals([
+          "pending",
+          "processing",
+          "succeeded",
+          "failed",
+          "retrying",
+        ]),
+        createdAt: Schema.String,
+        succeededAt: Schema.optional(Schema.String),
+        retryCount: Schema.Number,
+        response: Schema.optional(
+          Schema.Struct({
+            httpCode: Schema.optional(Schema.Number),
+            elapsedTimeMs: Schema.optional(Schema.Number),
+            body: Schema.optional(Schema.String),
+            errorName: Schema.optional(Schema.String),
+          }),
+        ),
+      }),
+    ),
+  });
+export type ListWebhookSubscriptionEventsOutput =
+  typeof ListWebhookSubscriptionEventsOutput.Type;
+
+// The operation
+/**
+ * List webhook subscription events
+ *
+ * Retrieve webhook event delivery attempts for a specific subscription.
+ * Returns event deliveries in descending order by creation time (newest first),
+ * including delivery status, retry count, and response details.
+ * ### Use Cases
+ * - Debug webhook delivery failures and inspect response codes
+ * - Monitor delivery status and retry counts
+ * - Audit event delivery history for a subscription
+ * - Verify that expected events were sent to webhook URLs
+ * ### Filtering
+ * Use optional query parameters to narrow results:
+ * - `eventId` — find a specific event by ID
+ * - `minCreatedAt` / `maxCreatedAt` — filter by time range
+ * - `eventTypeNames` — filter by event type (comma-separated)
+ * **Note:** Results are limited to the 50 most recent events (newest first). No pagination is supported.
+ *
+ * @param subscriptionId - Unique identifier for the webhook subscription.
+ * @param eventId - Filter by a specific event ID.
+ * @param minCreatedAt - Filter events created at or after this timestamp (RFC 3339 format).
+ * @param maxCreatedAt - Filter events created at or before this timestamp (RFC 3339 format).
+ * @param eventTypeNames - Filter by event type names (comma-separated).
+ */
+export const listWebhookSubscriptionEvents =
+  /*@__PURE__*/ /*#__PURE__*/ API.make(() => ({
+    inputSchema: ListWebhookSubscriptionEventsInput,
+    outputSchema: ListWebhookSubscriptionEventsOutput,
+  }));

package/src/operations/listWebhookSubscriptions.ts

@@ -18,6 +18,7 @@ export const ListWebhookSubscriptionsOutput =
     subscriptions: Schema.Array(
       Schema.Struct({
         createdAt: Schema.String,
+        updatedAt: Schema.optional(Schema.String),
         description: Schema.optional(Schema.Struct({})),
         eventTypes: Schema.Array(Schema.String),
         isEnabled: Schema.Boolean,

package/src/operations/requestSolanaFaucet.ts

@@ -6,7 +6,7 @@ import * as T from "../traits";
 export const RequestSolanaFaucetInput =
   /*@__PURE__*/ /*#__PURE__*/ Schema.Struct({
     address: Schema.String,
-    token: Schema.Literals(["sol", "usdc"]),
+    token: Schema.Literals(["sol", "usdc", "cbtusd"]),
   }).pipe(T.Http({ method: "POST", path: "/v2/solana/faucet" }));
 export type RequestSolanaFaucetInput = typeof RequestSolanaFaucetInput.Type;
 
@@ -22,7 +22,7 @@ export type RequestSolanaFaucetOutput = typeof RequestSolanaFaucetOutput.Type;
  * Request funds on Solana devnet
  *
  * Request funds from the CDP Faucet on Solana devnet.
- * Faucets are available for SOL.
+ * Faucets are available for SOL, USDC, and CBTUSD.
  * To prevent abuse, we enforce rate limits within a rolling 24-hour window to control the amount of funds that can be requested.
  * These limits are applied at both the CDP Project level and the blockchain address level.
  * A single blockchain address cannot exceed the specified limits, even if multiple users submit requests to the same address.

package/src/operations/runSQLQuery.ts

@@ -72,19 +72,31 @@ export type RunSQLQueryOutput = typeof RunSQLQueryOutput.Type;
  * This endpoint provides direct SQL access to comprehensive blockchain data across supported networks.
  * Queries are executed against optimized data structures for high-performance analytics.
  * ### Allowed Queries
- * - Standard SQL syntax (ClickHouse dialect)
+ * - Standard SQL syntax (CoinbaSeQL dialect, based on ClickHouse dialect)
  * - Read-only queries (SELECT statements)
  * - No DDL or DML operations
- * - No cartesian products
+ * - Query that follow limits (defined below)
  * ### Supported Tables
- * - `base.events` - Base mainnet decoded event logs with parameters, event signature, topics, and more.
- * - `base.transactions` - Base mainnet transaction data including hash, block number, gas usage.
- * - `base.blocks` - Base mainnet block information.
- * - `base.encoded_logs` - Encoded log data of event logs that aren't able to be decoded by our event decoder (ex: log0 opcode).
- * - `base.transfers` - All event logs with event signature `Transfer(address,address,uint256)`. ERC-20, ERC-721, and ERC-1155 transfers are all included.
+ * - `<network>.events` - Base mainnet decoded event logs with parameters, event signature, topics, and more.
+ * - `<network>.transactions` - Base mainnet transaction data including hash, block number, gas usage.
+ * - `<network>.blocks` - Base mainnet block information.
+ * - `<network>.encoded_logs` - Encoded log data of event logs that aren't able to be decoded by our event decoder (ex: log0 opcode).
+ * - `<network>.decoded_user_operations` - Decoded user operations data including hash, block number, gas usage, builder codes, entrypoint version, and more.
+ * - `<network>.transaction_attributions` - Information about the attributions of a transaction to a builder and associated builder codes.
+ * ### Supported Networks
+ * - Base Mainnet: `base`
+ * - Base Sepolia: `base_sepolia`
+ * So for example, valid tables are: `base.events`, `base_sepolia.events`, `base.transactions`, etc.
  * ### Query Limits
- * - Maximum result set: 100,000 rows
+ * - Maximum result set: 50,000 rows
+ * - Maximum query length: 10,000 characters
+ * - Maximum on-disk data to read: 100GB
+ * - Maximum memory usage: 15GB
  * - Query timeout: 30 seconds
+ * - Maximum JOINs: 12
+ * ### Query Caching
+ * By default, each query result is returned from cache so long as the result is from an identical query and less than 750ms old. This freshness tolerance can be modified upwards, to a maximum of 900000ms (i.e. 900s, 15m).
+ * This can be helpful for users who wish to reduce expensive calls to the SQL API by reusing cached results.
  */
 export const runSQLQuery = /*@__PURE__*/ /*#__PURE__*/ API.make(() => ({
   inputSchema: RunSQLQueryInput,

package/src/operations/sendSolanaTransaction.ts

@@ -7,6 +7,7 @@ export const SendSolanaTransactionInput =
   /*@__PURE__*/ /*#__PURE__*/ Schema.Struct({
     network: Schema.Literals(["solana", "solana-devnet"]),
     transaction: Schema.String,
+    useCdpSponsor: Schema.optional(Schema.Boolean),
   }).pipe(
     T.Http({ method: "POST", path: "/v2/solana/accounts/send/transaction" }),
   );

package/src/operations/settleX402Payment.ts

@@ -72,6 +72,7 @@ export const SettleX402PaymentOutput =
     payer: Schema.String,
     transaction: Schema.String,
     network: Schema.String,
+    amount: Schema.optional(Schema.String),
   });
 export type SettleX402PaymentOutput = typeof SettleX402PaymentOutput.Type;
 

package/src/operations/supportedX402PaymentKinds.ts

@@ -16,7 +16,7 @@ export const SupportedX402PaymentKindsOutput =
     kinds: Schema.Array(
       Schema.Struct({
         x402Version: Schema.Literals(["1", "2"]),
-        scheme: Schema.Literals(["exact"]),
+        scheme: Schema.Literals(["exact", "upto"]),
         network: Schema.Literals([
           "base-sepolia",
           "base",

package/src/operations/updateWebhookSubscription.ts

@@ -29,6 +29,7 @@ export type UpdateWebhookSubscriptionInput =
 export const UpdateWebhookSubscriptionOutput =
   /*@__PURE__*/ /*#__PURE__*/ Schema.Struct({
     createdAt: Schema.String,
+    updatedAt: Schema.optional(Schema.String),
     description: Schema.optional(Schema.Struct({})),
     eventTypes: Schema.Array(Schema.String),
     isEnabled: Schema.Boolean,

package/src/retry.ts

@@ -3,7 +3,7 @@
  */
 import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
-import * as ServiceMap from "effect/ServiceMap";
+import * as Context from "effect/Context";
 export {
   type Options,
   type Factory,
@@ -19,9 +19,7 @@ import type { Policy } from "@distilled.cloud/core/retry";
 /**
  * Context tag for configuring retry behavior of Coinbase API calls.
  */
-export class Retry extends ServiceMap.Service<Retry, Policy>()(
-  "CoinbaseRetry",
-) {}
+export class Retry extends Context.Service<Retry, Policy>()("CoinbaseRetry") {}
 
 /**
  * Provides a custom retry policy to all Coinbase API calls.