@distilled.cloud/coinbase 1.0.0-rc.1 → 1.0.0-rc.3

package/lib/protocol.js

@@ -0,0 +1,324 @@
+/**
+ * CoinbaseProtocol — hand-written.
+ *
+ * Speaks the Coinbase CDP JSON protocol. The generic request/response
+ * machinery (trait-driven request building, recursive wire-name mapping)
+ * lives in `@distilled.cloud/core/protocol-http`; this module supplies what
+ * is Coinbase's own:
+ *
+ * ## Authentication
+ *
+ * The Coinbase CDP API uses per-request JWT bearer tokens. The JWT is signed
+ * with your CDP API Key Secret (ES256 or Ed25519) and includes:
+ *
+ * - `sub`: Your CDP API Key ID
+ * - `iss`: "cdp"
+ * - `aud`: ["cdp_service"]
+ * - `exp`: Current time + 120 seconds
+ * - `uri`: "METHOD host/path"
+ *
+ * Some sensitive wallet operations additionally document an `X-Wallet-Auth`
+ * header signed with your Wallet Secret (`Config.walletSecret`); like the
+ * distilled v0 client, this module does not generate that header.
+ *
+ * ## Error Handling
+ *
+ * Coinbase CDP errors have the shape:
+ * ```json
+ * {
+ *   "errorType": "invalid_request",
+ *   "errorMessage": "Invalid request.",
+ *   "correlationId": "41deb8d59a9dc9a7-IAD",
+ *   "errorLink": "https://docs.cdp.coinbase.com/api-reference/v2/errors#invalid-request"
+ * }
+ * ```
+ *
+ * Errors are handled globally (no per-operation error lists), dispatched
+ * first by `errorType`, then by HTTP status code.
+ */
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Redacted from "effect/Redacted";
+import * as Schema from "effect/Schema";
+import * as crypto from "node:crypto";
+import * as HttpClientRequest from "effect/unstable/http/HttpClientRequest";
+import * as API from "@distilled.cloud/core/api";
+import { buildRequest, mapKeys } from "@distilled.cloud/core/protocol-http";
+import { unwrapRedactedDeep, wrapSensitive, } from "@distilled.cloud/core/protocol-rest";
+import { HTTP_STATUS_MAP, } from "@distilled.cloud/core/errors";
+import { parseRetryAfterForStatus } from "@distilled.cloud/core/retry-after";
+import { Credentials } from "./credentials.js";
+import { COINBASE_HTTP_STATUS_MAP, ERROR_TYPE_MAP, STANDARD_ERROR_TYPE_MAP, UnknownCoinbaseError, } from "./errors.js";
+// Bridge: Protocol.decode is typed as Effect<unknown> (no error channel), but
+// Coinbase failures are real typed errors that the operation's explicit
+// `CoinbaseOpError` annotation re-surfaces. Fail with the instance and erase
+// the error type here.
+const fail = (e) => Effect.fail(e);
+// ============================================================================
+// JWT generation for Coinbase CDP API authentication
+// ============================================================================
+/**
+ * Base64url-encode a buffer.
+ */
+const base64url = (buf) => Buffer.from(buf)
+    .toString("base64")
+    .replace(/\+/g, "-")
+    .replace(/\//g, "_")
+    .replace(/=+$/, "");
+/**
+ * Generate a random hex nonce.
+ */
+const randomNonce = () => crypto.randomBytes(16).toString("hex");
+/**
+ * Detect key type and return the appropriate signing algorithm and key object.
+ */
+const resolveSigningKey = (apiKeySecret) => {
+    // Try EC (ES256) first — PEM format
+    if (apiKeySecret.includes("-----BEGIN")) {
+        return {
+            algorithm: "ES256",
+            jwsAlg: "ES256",
+            key: crypto.createPrivateKey(apiKeySecret),
+        };
+    }
+    // Ed25519 — base64 encoded 64-byte key (32 seed + 32 public)
+    const keyBytes = Buffer.from(apiKeySecret, "base64");
+    if (keyBytes.length === 64) {
+        // Extract the 32-byte seed (private key)
+        const seed = keyBytes.subarray(0, 32);
+        // Import as Ed25519 private key using PKCS8 DER wrapping
+        // Ed25519 PKCS8 prefix: 302e020100300506032b657004220420
+        const pkcs8Prefix = Buffer.from("302e020100300506032b657004220420", "hex");
+        const pkcs8Der = Buffer.concat([pkcs8Prefix, seed]);
+        return {
+            algorithm: "EdDSA",
+            jwsAlg: "EdDSA",
+            key: crypto.createPrivateKey({
+                key: pkcs8Der,
+                format: "der",
+                type: "pkcs8",
+            }),
+        };
+    }
+    throw new Error("Unsupported CDP API Key Secret format. Expected EC PEM or Ed25519 base64.");
+};
+/**
+ * Generate a JWT bearer token for Coinbase CDP API authentication.
+ *
+ * The JWT includes:
+ * - header: { alg, kid, typ: "JWT", nonce }
+ * - payload: { sub, iss: "cdp", aud, nbf, exp, uri }
+ */
+const generateJwt = (apiKeyId, apiKeySecret, method, uri) => {
+    const { jwsAlg, key } = resolveSigningKey(apiKeySecret);
+    const now = Math.floor(Date.now() / 1000);
+    const header = {
+        alg: jwsAlg,
+        kid: apiKeyId,
+        typ: "JWT",
+        nonce: randomNonce(),
+    };
+    const payload = {
+        sub: apiKeyId,
+        iss: "cdp",
+        aud: ["cdp_service"],
+        nbf: now,
+        exp: now + 120,
+        uri: `${method} ${uri}`,
+    };
+    const headerB64 = base64url(Buffer.from(JSON.stringify(header)));
+    const payloadB64 = base64url(Buffer.from(JSON.stringify(payload)));
+    const signingInput = `${headerB64}.${payloadB64}`;
+    let signature;
+    if (jwsAlg === "ES256") {
+        // ES256 uses SHA-256 with ECDSA, needs IEEE P1363 format (not DER)
+        const sign = crypto.createSign("SHA256");
+        sign.update(signingInput);
+        const derSig = sign.sign(key);
+        // Convert DER signature to IEEE P1363 (raw r||s) format
+        signature = derToP1363(derSig, 32);
+    }
+    else {
+        // EdDSA (Ed25519) uses sign directly
+        signature = Buffer.from(crypto.sign(null, Buffer.from(signingInput), key));
+    }
+    return `${signingInput}.${base64url(signature)}`;
+};
+/**
+ * Convert a DER-encoded ECDSA signature to IEEE P1363 (raw r||s) format.
+ * JWS requires P1363 format for ES256.
+ */
+const derToP1363 = (derSig, componentLength) => {
+    // DER format: 30 <len> 02 <rLen> <r> 02 <sLen> <s>
+    let offset = 2; // skip 30 <len>
+    if (derSig[1] & 0x80)
+        offset += derSig[1] & 0x7f;
+    // Read r
+    offset++; // skip 02
+    const rLen = derSig[offset++];
+    const r = derSig.subarray(offset, offset + rLen);
+    offset += rLen;
+    // Read s
+    offset++; // skip 02
+    const sLen = derSig[offset++];
+    const s = derSig.subarray(offset, offset + sLen);
+    // Pad or trim to componentLength
+    const result = Buffer.alloc(componentLength * 2);
+    const rPadded = r.length > componentLength ? r.subarray(r.length - componentLength) : r;
+    const sPadded = s.length > componentLength ? s.subarray(s.length - componentLength) : s;
+    rPadded.copy(result, componentLength - rPadded.length);
+    sPadded.copy(result, componentLength * 2 - sPadded.length);
+    return result;
+};
+// ============================================================================
+// Error response parsing
+// ============================================================================
+/**
+ * Coinbase CDP API Error Response Schema.
+ *
+ * All Coinbase CDP errors have the same envelope:
+ * { errorType, errorMessage, correlationId?, errorLink? }
+ */
+const CoinbaseErrorResponse = Schema.Struct({
+    errorType: Schema.String,
+    errorMessage: Schema.String,
+    correlationId: Schema.optional(Schema.String),
+    errorLink: Schema.optional(Schema.String),
+});
+/**
+ * Match a Coinbase CDP API error response to the appropriate typed error
+ * class. Ported from the distilled v0 client's `matchError`.
+ *
+ * Dispatches errors by:
+ * 1. The `errorType` field for Coinbase-specific errors (e.g., "already_exists", "policy_violation")
+ * 2. The `errorType` field for standard errors mapped to core classes (e.g., "not_found" → NotFound)
+ * 3. Standard HTTP status codes mapped from core (400, 401, 403, 404, etc.)
+ * 4. Coinbase-specific HTTP status codes (402)
+ * 5. Falls back to UnknownCoinbaseError for unrecognized errors
+ *
+ * Error bodies carrying `isValid`/`success` keys are policy-validation
+ * results delivered with an error status — treated as success values
+ * (`Effect.succeed`) like the v0 client did.
+ */
+const matchError = (status, errorBody, headers) => {
+    if (errorBody &&
+        typeof errorBody === "object" &&
+        ("isValid" in errorBody || "success" in errorBody)) {
+        return Effect.succeed(errorBody);
+    }
+    try {
+        const parsed = Schema.decodeUnknownSync(CoinbaseErrorResponse)(errorBody);
+        const errorProps = {
+            errorType: parsed.errorType,
+            errorMessage: parsed.errorMessage,
+            correlationId: parsed.correlationId,
+            errorLink: parsed.errorLink,
+        };
+        // 1. Match by Coinbase-specific error type first
+        const TypedErrorClass = ERROR_TYPE_MAP[parsed.errorType];
+        if (TypedErrorClass) {
+            return fail(new TypedErrorClass(errorProps));
+        }
+        // 2. Match standard error types to core HTTP error classes
+        // Maps error types like "not_found", "forbidden", "unauthorized",
+        // "invalid_request", "rate_limit_exceeded", "internal_server_error",
+        // "bad_gateway", "service_unavailable" to core HTTP error classes.
+        const StandardErrorClass = STANDARD_ERROR_TYPE_MAP[parsed.errorType];
+        if (StandardErrorClass) {
+            return fail(new StandardErrorClass({
+                message: parsed.errorMessage ?? "",
+                retryAfter: parseRetryAfterForStatus(status, headers),
+            }));
+        }
+        // 3. Fall back to HTTP status code mapping from core
+        const CoreErrorClass = HTTP_STATUS_MAP[status];
+        if (CoreErrorClass) {
+            return fail(new CoreErrorClass({
+                message: parsed.errorMessage ?? "",
+                retryAfter: parseRetryAfterForStatus(status, headers),
+            }));
+        }
+        // 4. Coinbase-specific HTTP status codes (402)
+        const CoinbaseErrorClass = COINBASE_HTTP_STATUS_MAP[status];
+        if (CoinbaseErrorClass) {
+            return fail(new CoinbaseErrorClass(errorProps));
+        }
+        // 5. Fall back to unknown error
+        return fail(new UnknownCoinbaseError({
+            ...errorProps,
+            body: errorBody,
+        }));
+    }
+    catch {
+        return fail(new UnknownCoinbaseError({ body: errorBody }));
+    }
+};
+// ============================================================================
+// Protocol
+// ============================================================================
+// The protocol layer is memoized per process by `API.make`, so the build must
+// not capture credentials — `encode` resolves Credentials from the calling
+// fiber's context on every request instead. Like the error channel above,
+// the requirement is erased at this boundary (Protocol effects are typed with
+// no requirements) and reintroduced for callers by the generated
+// `CoinbaseOpContext` annotations.
+const encode = ({ input, inputAst, }) => Effect.gen(function* () {
+    // The Credentials service holds an effect — resolving it here (per
+    // request) picks up rotations. Its error channel is erased at this
+    // boundary; CoinbaseOpError reintroduces it for callers.
+    const resolveCredentials = yield* Credentials;
+    const creds = (yield* resolveCredentials);
+    // Sensitive input members accept string | Redacted<string>; the wire
+    // wants the raw string.
+    const request = buildRequest({
+        input: unwrapRedactedDeep(input),
+        inputAst,
+        baseUrl: creds.apiBaseUrl,
+    });
+    // JWT `uri` claim: "METHOD host/path" — label-substituted path, no query
+    // string (matches the v0 client: baseUrl.host + baseUrl.pathname +
+    // parts.path).
+    const url = new URL(request.url);
+    const jwt = generateJwt(creds.apiKeyId, Redacted.value(creds.apiKeySecret), request.method, `${url.host}${url.pathname}`);
+    return request.pipe(HttpClientRequest.setHeader("Authorization", `Bearer ${jwt}`));
+});
+const decode = ({ response, outputAst, }) => Effect.gen(function* () {
+    const text = (yield* response.text.pipe(Effect.orDie)) ?? "";
+    if (process.env.DISTILLED_DEBUG_HTTP) {
+        console.error(`[distilled] <- ${response.status} ${text.slice(0, 400)}`);
+    }
+    let json;
+    if (text.trim().length > 0) {
+        try {
+            json = JSON.parse(text);
+        }
+        catch {
+            json = text;
+        }
+    }
+    const status = response.status;
+    const headers = response.headers;
+    if (status >= 400) {
+        const result = yield* matchError(status, json, headers);
+        // isValid/success bodies are success values delivered with an error
+        // status — map them onto the output schema like a normal response.
+        return wrapSensitive(outputAst, mapKeys(outputAst, result, "decode"));
+    }
+    // No envelope: the response body IS the payload, mapped onto the output
+    // schema (wire names → TS names), with members marked T.SensitiveValue
+    // delivered as Redacted.
+    const body = json === undefined ? {} : json;
+    return wrapSensitive(outputAst, mapKeys(outputAst, body, "decode"));
+});
+/**
+ * Coinbase CDP protocol layer.
+ *
+ * Uses JWT bearer token authentication signed per request with your CDP API
+ * Key Secret.
+ */
+export const CoinbaseProtocol = Layer.succeed(API.Protocol, API.Protocol.of({
+    // Erase encode's Credentials requirement (see comment above).
+    encode: (args) => encode(args),
+    decode,
+}));
+//# sourceMappingURL=protocol.js.map

package/lib/protocol.js.map

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

package/lib/retry.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Coinbase retry configuration.
+ *
+ * Defines the per-SDK `Retry` Context.Service tag that generated operations
+ * wire into `API.make({ retry: Retry.Retry })`. Callers can install a
+ * blanket retry policy at the layer level and have every Coinbase API call
+ * below it pick it up:
+ *
+ * @example
+ * ```ts
+ * import * as Coinbase from "@distilled.cloud/coinbase";
+ *
+ * myEffect.pipe(Coinbase.Retry.transient);
+ * Effect.provide(myEffect, Layer.succeed(Coinbase.Retry.Retry, customPolicy));
+ * ```
+ */
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import { type Policy } from "@distilled.cloud/core/retry";
+export { type Options, type Factory, type Policy, makeDefault, jittered, capped, throttlingOptions, transientOptions, throttlingFactory, transientFactory, } from "@distilled.cloud/core/retry";
+declare const Retry_base: Context.ServiceClass<Retry, "CoinbaseRetry", Policy>;
+/** Context tag for configuring retry behavior of Coinbase API calls. */
+export declare class Retry extends Retry_base {
+}
+/** Provides a custom retry policy to every Coinbase API call below it. */
+export declare const policy: (optionsOrFactory: Policy) => <A, E, R>(self: Effect.Effect<A, E, R>) => Effect.Effect<A, E, Exclude<R, Retry>>;
+/** Disables all automatic retries. */
+export declare const none: <A, E, R>(self: Effect.Effect<A, E, R>) => Effect.Effect<A, E, Exclude<R, Retry>>;
+/** Apply the throttling retry policy (retries throttling errors indefinitely). */
+export declare const throttling: <A, E, R>(self: Effect.Effect<A, E, R>) => Effect.Effect<A, E, Exclude<R, Retry>>;
+/** Apply the transient retry policy (retries all transient errors indefinitely). */
+export declare const transient: <A, E, R>(self: Effect.Effect<A, E, R>) => Effect.Effect<A, E, Exclude<R, Retry>>;
+//# sourceMappingURL=retry.d.ts.map

package/lib/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EACL,KAAK,MAAM,EAGZ,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,OAAO,EACZ,KAAK,MAAM,EACX,WAAW,EACX,QAAQ,EACR,MAAM,EACN,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;;AAErC,wEAAwE;AACxE,qBAAa,KAAM,SAAQ,UAAiD;CAAG;AAE/E,0EAA0E;AAC1E,eAAO,MAAM,MAAM,qBAAsB,MAAM,sFACS,CAAC;AAEzD,sCAAsC;AACtC,eAAO,MAAM,IAAI,mFAEhB,CAAC;AAEF,kFAAkF;AAClF,eAAO,MAAM,UAAU,mFAA4B,CAAC;AAEpD,oFAAoF;AACpF,eAAO,MAAM,SAAS,mFAA2B,CAAC"}

package/lib/retry.js

@@ -0,0 +1,33 @@
+/**
+ * Coinbase retry configuration.
+ *
+ * Defines the per-SDK `Retry` Context.Service tag that generated operations
+ * wire into `API.make({ retry: Retry.Retry })`. Callers can install a
+ * blanket retry policy at the layer level and have every Coinbase API call
+ * below it pick it up:
+ *
+ * @example
+ * ```ts
+ * import * as Coinbase from "@distilled.cloud/coinbase";
+ *
+ * myEffect.pipe(Coinbase.Retry.transient);
+ * Effect.provide(myEffect, Layer.succeed(Coinbase.Retry.Retry, customPolicy));
+ * ```
+ */
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { throttlingFactory, transientFactory, } from "@distilled.cloud/core/retry";
+export { makeDefault, jittered, capped, throttlingOptions, transientOptions, throttlingFactory, transientFactory, } from "@distilled.cloud/core/retry";
+/** Context tag for configuring retry behavior of Coinbase API calls. */
+export class Retry extends Context.Service()("CoinbaseRetry") {
+}
+/** Provides a custom retry policy to every Coinbase API call below it. */
+export const policy = (optionsOrFactory) => Effect.provide(Layer.succeed(Retry, optionsOrFactory));
+/** Disables all automatic retries. */
+export const none = Effect.provide(Layer.succeed(Retry, { while: () => false }));
+/** Apply the throttling retry policy (retries throttling errors indefinitely). */
+export const throttling = policy(throttlingFactory);
+/** Apply the transient retry policy (retries all transient errors indefinitely). */
+export const transient = policy(transientFactory);
+//# sourceMappingURL=retry.js.map

package/lib/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,EAEL,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAIL,WAAW,EACX,QAAQ,EACR,MAAM,EACN,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AAErC,wEAAwE;AACxE,MAAM,OAAO,KAAM,SAAQ,OAAO,CAAC,OAAO,EAAiB,CAAC,eAAe,CAAC;CAAG;AAE/E,0EAA0E;AAC1E,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,sCAAsC;AACtC,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;AAEF,kFAAkF;AAClF,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAEpD,oFAAoF;AACpF,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC"}