@blindmarket/sdk 0.1.4

package/dist/network/index.cjs

@@ -0,0 +1,74 @@
+'use strict';
+
+// src/network/presets.ts
+var networks = {
+  testnet: {
+    name: "0g-galileo-testnet",
+    chainId: 16602n,
+    rpc: ["https://evmrpc-testnet.0g.ai"],
+    contracts: {
+      escrow: "0xFd4F93F5A7BE144c405D1D8fbEC63Fb776207681",
+      registry: "0xeE52d780A47F77E8a4a1cEb236e3C65A48FbD828",
+      reputation: "0x4A6374Fae37E19E69ba43E7cf6994AC15F63256e",
+      usdc: "0x317227efcA18D004E12CA8046AEf7E1597458F25"
+    },
+    indexer: "https://indexer-storage-testnet-turbo.0g.ai",
+    broker: "https://broker.testnet.0g.ai",
+    explorer: "https://chainscan-galileo.0g.ai"
+  }
+};
+
+// src/errors/BlindBountyError.ts
+var BlindBountyError = class extends Error {
+  code;
+  retriable;
+  context;
+  cause;
+  constructor(code, message, opts = {}) {
+    super(message);
+    this.code = code;
+    this.retriable = opts.retriable ?? false;
+    if (opts.context !== void 0) this.context = opts.context;
+    if (opts.cause !== void 0) this.cause = opts.cause;
+    Object.defineProperty(this, "name", {
+      value: this.constructor.name,
+      enumerable: false,
+      configurable: true,
+      writable: true
+    });
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      code: this.code,
+      message: this.message,
+      retriable: this.retriable,
+      ...this.context ? { context: this.context } : {}
+    };
+  }
+};
+
+// src/errors/subclasses.ts
+var ConfigError = class extends BlindBountyError {
+  constructor(code, msg, opts) {
+    super(code, msg, opts);
+  }
+};
+
+// src/network/resolve.ts
+function resolveNetwork(arg) {
+  if (typeof arg === "string") {
+    const preset = networks[arg];
+    if (!preset) {
+      const known = Object.keys(networks).join(", ");
+      throw new ConfigError("CONFIG/INVALID_NETWORK", `unknown network '${arg}' (known: ${known})`);
+    }
+    return preset;
+  }
+  return arg;
+}
+
+exports.networks = networks;
+exports.resolveNetwork = resolveNetwork;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/network/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/network/presets.ts","../../src/errors/BlindBountyError.ts","../../src/errors/subclasses.ts","../../src/network/resolve.ts"],"names":[],"mappings":";;;AASO,IAAM,QAAA,GAAW;AAAA,EACtB,OAAA,EAAS;AAAA,IACP,IAAA,EAAM,oBAAA;AAAA,IACN,OAAA,EAAS,MAAA;AAAA,IACT,GAAA,EAAK,CAAC,8BAA8B,CAAA;AAAA,IACpC,SAAA,EAAW;AAAA,MACT,MAAA,EAAQ,4CAAA;AAAA,MACR,QAAA,EAAU,4CAAA;AAAA,MACV,UAAA,EAAY,4CAAA;AAAA,MACZ,IAAA,EAAM;AAAA,KACR;AAAA,IACA,OAAA,EAAS,6CAAA;AAAA,IACT,MAAA,EAAQ,8BAAA;AAAA,IACR,QAAA,EAAU;AAAA;AAEd;;;AChBO,IAAe,gBAAA,GAAf,cAAwC,KAAA,CAAM;AAAA,EAC1C,IAAA;AAAA,EACA,SAAA;AAAA,EACA,OAAA;AAAA,EACS,KAAA;AAAA,EAElB,WAAA,CAAY,IAAA,EAAiB,OAAA,EAAiB,IAAA,GAAqB,EAAC,EAAG;AACrE,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AACZ,IAAA,IAAA,CAAK,SAAA,GAAY,KAAK,SAAA,IAAa,KAAA;AACnC,IAAA,IAAI,IAAA,CAAK,OAAA,KAAY,MAAA,EAAW,IAAA,CAAK,UAAU,IAAA,CAAK,OAAA;AACpD,IAAA,IAAI,IAAA,CAAK,KAAA,KAAU,MAAA,EAAW,IAAA,CAAK,QAAQ,IAAA,CAAK,KAAA;AAChD,IAAA,MAAA,CAAO,cAAA,CAAe,MAAM,MAAA,EAAQ;AAAA,MAClC,KAAA,EAAO,KAAK,WAAA,CAAY,IAAA;AAAA,MACxB,UAAA,EAAY,KAAA;AAAA,MACZ,YAAA,EAAc,IAAA;AAAA,MACd,QAAA,EAAU;AAAA,KACX,CAAA;AAAA,EACH;AAAA,EAEA,MAAA,GAAkC;AAChC,IAAA,OAAO;AAAA,MACL,MAAM,IAAA,CAAK,IAAA;AAAA,MACX,MAAM,IAAA,CAAK,IAAA;AAAA,MACX,SAAS,IAAA,CAAK,OAAA;AAAA,MACd,WAAW,IAAA,CAAK,SAAA;AAAA,MAChB,GAAI,KAAK,OAAA,GAAU,EAAE,SAAS,IAAA,CAAK,OAAA,KAAY;AAAC,KAClD;AAAA,EACF;AACF,CAAA;;;ACzBO,IAAM,WAAA,GAAN,cAA0B,gBAAA,CAAiB;AAAA,EAChD,WAAA,CAAY,IAAA,EAAkB,GAAA,EAAa,IAAA,EAAqB;AAC9D,IAAA,KAAA,CAAM,IAAA,EAAM,KAAK,IAAI,CAAA;AAAA,EACvB;AACF,CAAA;;;ACRO,SAAS,eAAe,GAAA,EAAqC;AAClE,EAAA,IAAI,OAAO,QAAQ,QAAA,EAAU;AAC3B,IAAA,MAAM,MAAA,GAAU,SAAiD,GAAG,CAAA;AACpE,IAAA,IAAI,CAAC,MAAA,EAAQ;AACX,MAAA,MAAM,QAAQ,MAAA,CAAO,IAAA,CAAK,QAAQ,CAAA,CAAE,KAAK,IAAI,CAAA;AAC7C,MAAA,MAAM,IAAI,WAAA,CAAY,wBAAA,EAA0B,oBAAoB,GAAG,CAAA,UAAA,EAAa,KAAK,CAAA,CAAA,CAAG,CAAA;AAAA,IAC9F;AACA,IAAA,OAAO,MAAA;AAAA,EACT;AACA,EAAA,OAAO,GAAA;AACT","file":"index.cjs","sourcesContent":["import type { Network } from './types.js';\n\n/**\n * Known-good network presets. Addresses pinned per SDK version so upgrading\n * the SDK cannot silently move contracts under a consumer.\n *\n * testnet = 0G Galileo (chainId 16602) — addresses from\n * contracts/deployments/0g-testnet.json (deployed 2026-04-15).\n */\nexport const networks = {\n  testnet: {\n    name: '0g-galileo-testnet',\n    chainId: 16602n,\n    rpc: ['https://evmrpc-testnet.0g.ai'],\n    contracts: {\n      escrow: '0xFd4F93F5A7BE144c405D1D8fbEC63Fb776207681',\n      registry: '0xeE52d780A47F77E8a4a1cEb236e3C65A48FbD828',\n      reputation: '0x4A6374Fae37E19E69ba43E7cf6994AC15F63256e',\n      usdc: '0x317227efcA18D004E12CA8046AEf7E1597458F25',\n    },\n    indexer: 'https://indexer-storage-testnet-turbo.0g.ai',\n    broker: 'https://broker.testnet.0g.ai',\n    explorer: 'https://chainscan-galileo.0g.ai',\n  },\n} as const satisfies Record<string, Network>;\n\nexport type NetworkName = keyof typeof networks;\n","import type { ErrorCode } from './codes.js';\n\nexport interface ErrorOptions {\n  retriable?: boolean;\n  context?: Record<string, unknown>;\n  cause?: unknown;\n}\n\nexport abstract class BlindBountyError extends Error {\n  readonly code: ErrorCode;\n  readonly retriable: boolean;\n  readonly context?: Record<string, unknown>;\n  override readonly cause?: unknown;\n\n  constructor(code: ErrorCode, message: string, opts: ErrorOptions = {}) {\n    super(message);\n    this.code = code;\n    this.retriable = opts.retriable ?? false;\n    if (opts.context !== undefined) this.context = opts.context;\n    if (opts.cause !== undefined) this.cause = opts.cause;\n    Object.defineProperty(this, 'name', {\n      value: this.constructor.name,\n      enumerable: false,\n      configurable: true,\n      writable: true,\n    });\n  }\n\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      code: this.code,\n      message: this.message,\n      retriable: this.retriable,\n      ...(this.context ? { context: this.context } : {}),\n    };\n  }\n}\n","import { BlindBountyError, type ErrorOptions } from './BlindBountyError.js';\nimport type {\n  ApiCode,\n  ChainCode,\n  ComputeCode,\n  ConfigCode,\n  CryptoCode,\n  LifecycleCode,\n  StorageCode,\n  TimeoutCode,\n} from './codes.js';\n\nexport class ConfigError extends BlindBountyError {\n  constructor(code: ConfigCode, msg: string, opts?: ErrorOptions) {\n    super(code, msg, opts);\n  }\n}\n\nexport class CryptoError extends BlindBountyError {\n  constructor(code: CryptoCode, msg: string, opts?: ErrorOptions) {\n    super(code, msg, opts);\n  }\n}\n\nexport class StorageError extends BlindBountyError {\n  constructor(code: StorageCode, msg: string, opts?: ErrorOptions) {\n    super(code, msg, opts);\n  }\n}\n\nexport class ChainError extends BlindBountyError {\n  constructor(code: ChainCode, msg: string, opts?: ErrorOptions) {\n    super(code, msg, opts);\n  }\n}\n\nexport class ComputeError extends BlindBountyError {\n  constructor(code: ComputeCode, msg: string, opts?: ErrorOptions) {\n    super(code, msg, opts);\n  }\n}\n\nexport class ApiError extends BlindBountyError {\n  constructor(code: ApiCode, msg: string, opts?: ErrorOptions) {\n    super(code, msg, opts);\n  }\n}\n\nexport class LifecycleError extends BlindBountyError {\n  constructor(code: LifecycleCode, msg: string, opts?: ErrorOptions) {\n    super(code, msg, opts);\n  }\n}\n\nexport class TimeoutError extends BlindBountyError {\n  constructor(code: TimeoutCode, msg: string, opts?: ErrorOptions) {\n    super(code, msg, opts);\n  }\n}\n","import { ConfigError } from '../errors/index.js';\nimport { networks, type NetworkName } from './presets.js';\nimport type { Network } from './types.js';\n\n/**\n * Resolve a preset name or a literal Network object into the canonical\n * Network used throughout the SDK. Throws ConfigError for unknown names.\n */\nexport function resolveNetwork(arg: NetworkName | Network): Network {\n  if (typeof arg === 'string') {\n    const preset = (networks as Record<string, Network | undefined>)[arg];\n    if (!preset) {\n      const known = Object.keys(networks).join(', ');\n      throw new ConfigError('CONFIG/INVALID_NETWORK', `unknown network '${arg}' (known: ${known})`);\n    }\n    return preset;\n  }\n  return arg;\n}\n"]}

package/dist/network/index.d.cts

@@ -0,0 +1,36 @@
+import { N as Network } from '../types-V7_ZmUb-.cjs';
+export { a as NetworkContracts } from '../types-V7_ZmUb-.cjs';
+import '../types-BOG5Ub1z.cjs';
+
+/**
+ * Known-good network presets. Addresses pinned per SDK version so upgrading
+ * the SDK cannot silently move contracts under a consumer.
+ *
+ * testnet = 0G Galileo (chainId 16602) — addresses from
+ * contracts/deployments/0g-testnet.json (deployed 2026-04-15).
+ */
+declare const networks: {
+    readonly testnet: {
+        readonly name: "0g-galileo-testnet";
+        readonly chainId: 16602n;
+        readonly rpc: ["https://evmrpc-testnet.0g.ai"];
+        readonly contracts: {
+            readonly escrow: "0xFd4F93F5A7BE144c405D1D8fbEC63Fb776207681";
+            readonly registry: "0xeE52d780A47F77E8a4a1cEb236e3C65A48FbD828";
+            readonly reputation: "0x4A6374Fae37E19E69ba43E7cf6994AC15F63256e";
+            readonly usdc: "0x317227efcA18D004E12CA8046AEf7E1597458F25";
+        };
+        readonly indexer: "https://indexer-storage-testnet-turbo.0g.ai";
+        readonly broker: "https://broker.testnet.0g.ai";
+        readonly explorer: "https://chainscan-galileo.0g.ai";
+    };
+};
+type NetworkName = keyof typeof networks;
+
+/**
+ * Resolve a preset name or a literal Network object into the canonical
+ * Network used throughout the SDK. Throws ConfigError for unknown names.
+ */
+declare function resolveNetwork(arg: NetworkName | Network): Network;
+
+export { Network, type NetworkName, networks, resolveNetwork };

package/dist/network/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types.js';
+export * from './presets.js';
+export * from './resolve.js';

package/dist/network/index.js

@@ -0,0 +1,3 @@
+export * from './types.js';
+export * from './presets.js';
+export * from './resolve.js';

package/dist/network/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/network/presets.ts","../../src/errors/BlindBountyError.ts","../../src/errors/subclasses.ts","../../src/network/resolve.ts"],"names":[],"mappings":";AASO,IAAM,QAAA,GAAW;AAAA,EACtB,OAAA,EAAS;AAAA,IACP,IAAA,EAAM,oBAAA;AAAA,IACN,OAAA,EAAS,MAAA;AAAA,IACT,GAAA,EAAK,CAAC,8BAA8B,CAAA;AAAA,IACpC,SAAA,EAAW;AAAA,MACT,MAAA,EAAQ,4CAAA;AAAA,MACR,QAAA,EAAU,4CAAA;AAAA,MACV,UAAA,EAAY,4CAAA;AAAA,MACZ,IAAA,EAAM;AAAA,KACR;AAAA,IACA,OAAA,EAAS,6CAAA;AAAA,IACT,MAAA,EAAQ,8BAAA;AAAA,IACR,QAAA,EAAU;AAAA;AAEd;;;AChBO,IAAe,gBAAA,GAAf,cAAwC,KAAA,CAAM;AAAA,EAC1C,IAAA;AAAA,EACA,SAAA;AAAA,EACA,OAAA;AAAA,EACS,KAAA;AAAA,EAElB,WAAA,CAAY,IAAA,EAAiB,OAAA,EAAiB,IAAA,GAAqB,EAAC,EAAG;AACrE,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AACZ,IAAA,IAAA,CAAK,SAAA,GAAY,KAAK,SAAA,IAAa,KAAA;AACnC,IAAA,IAAI,IAAA,CAAK,OAAA,KAAY,MAAA,EAAW,IAAA,CAAK,UAAU,IAAA,CAAK,OAAA;AACpD,IAAA,IAAI,IAAA,CAAK,KAAA,KAAU,MAAA,EAAW,IAAA,CAAK,QAAQ,IAAA,CAAK,KAAA;AAChD,IAAA,MAAA,CAAO,cAAA,CAAe,MAAM,MAAA,EAAQ;AAAA,MAClC,KAAA,EAAO,KAAK,WAAA,CAAY,IAAA;AAAA,MACxB,UAAA,EAAY,KAAA;AAAA,MACZ,YAAA,EAAc,IAAA;AAAA,MACd,QAAA,EAAU;AAAA,KACX,CAAA;AAAA,EACH;AAAA,EAEA,MAAA,GAAkC;AAChC,IAAA,OAAO;AAAA,MACL,MAAM,IAAA,CAAK,IAAA;AAAA,MACX,MAAM,IAAA,CAAK,IAAA;AAAA,MACX,SAAS,IAAA,CAAK,OAAA;AAAA,MACd,WAAW,IAAA,CAAK,SAAA;AAAA,MAChB,GAAI,KAAK,OAAA,GAAU,EAAE,SAAS,IAAA,CAAK,OAAA,KAAY;AAAC,KAClD;AAAA,EACF;AACF,CAAA;;;ACzBO,IAAM,WAAA,GAAN,cAA0B,gBAAA,CAAiB;AAAA,EAChD,WAAA,CAAY,IAAA,EAAkB,GAAA,EAAa,IAAA,EAAqB;AAC9D,IAAA,KAAA,CAAM,IAAA,EAAM,KAAK,IAAI,CAAA;AAAA,EACvB;AACF,CAAA;;;ACRO,SAAS,eAAe,GAAA,EAAqC;AAClE,EAAA,IAAI,OAAO,QAAQ,QAAA,EAAU;AAC3B,IAAA,MAAM,MAAA,GAAU,SAAiD,GAAG,CAAA;AACpE,IAAA,IAAI,CAAC,MAAA,EAAQ;AACX,MAAA,MAAM,QAAQ,MAAA,CAAO,IAAA,CAAK,QAAQ,CAAA,CAAE,KAAK,IAAI,CAAA;AAC7C,MAAA,MAAM,IAAI,WAAA,CAAY,wBAAA,EAA0B,oBAAoB,GAAG,CAAA,UAAA,EAAa,KAAK,CAAA,CAAA,CAAG,CAAA;AAAA,IAC9F;AACA,IAAA,OAAO,MAAA;AAAA,EACT;AACA,EAAA,OAAO,GAAA;AACT","file":"index.js","sourcesContent":["import type { Network } from './types.js';\n\n/**\n * Known-good network presets. Addresses pinned per SDK version so upgrading\n * the SDK cannot silently move contracts under a consumer.\n *\n * testnet = 0G Galileo (chainId 16602) — addresses from\n * contracts/deployments/0g-testnet.json (deployed 2026-04-15).\n */\nexport const networks = {\n  testnet: {\n    name: '0g-galileo-testnet',\n    chainId: 16602n,\n    rpc: ['https://evmrpc-testnet.0g.ai'],\n    contracts: {\n      escrow: '0xFd4F93F5A7BE144c405D1D8fbEC63Fb776207681',\n      registry: '0xeE52d780A47F77E8a4a1cEb236e3C65A48FbD828',\n      reputation: '0x4A6374Fae37E19E69ba43E7cf6994AC15F63256e',\n      usdc: '0x317227efcA18D004E12CA8046AEf7E1597458F25',\n    },\n    indexer: 'https://indexer-storage-testnet-turbo.0g.ai',\n    broker: 'https://broker.testnet.0g.ai',\n    explorer: 'https://chainscan-galileo.0g.ai',\n  },\n} as const satisfies Record<string, Network>;\n\nexport type NetworkName = keyof typeof networks;\n","import type { ErrorCode } from './codes.js';\n\nexport interface ErrorOptions {\n  retriable?: boolean;\n  context?: Record<string, unknown>;\n  cause?: unknown;\n}\n\nexport abstract class BlindBountyError extends Error {\n  readonly code: ErrorCode;\n  readonly retriable: boolean;\n  readonly context?: Record<string, unknown>;\n  override readonly cause?: unknown;\n\n  constructor(code: ErrorCode, message: string, opts: ErrorOptions = {}) {\n    super(message);\n    this.code = code;\n    this.retriable = opts.retriable ?? false;\n    if (opts.context !== undefined) this.context = opts.context;\n    if (opts.cause !== undefined) this.cause = opts.cause;\n    Object.defineProperty(this, 'name', {\n      value: this.constructor.name,\n      enumerable: false,\n      configurable: true,\n      writable: true,\n    });\n  }\n\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      code: this.code,\n      message: this.message,\n      retriable: this.retriable,\n      ...(this.context ? { context: this.context } : {}),\n    };\n  }\n}\n","import { BlindBountyError, type ErrorOptions } from './BlindBountyError.js';\nimport type {\n  ApiCode,\n  ChainCode,\n  ComputeCode,\n  ConfigCode,\n  CryptoCode,\n  LifecycleCode,\n  StorageCode,\n  TimeoutCode,\n} from './codes.js';\n\nexport class ConfigError extends BlindBountyError {\n  constructor(code: ConfigCode, msg: string, opts?: ErrorOptions) {\n    super(code, msg, opts);\n  }\n}\n\nexport class CryptoError extends BlindBountyError {\n  constructor(code: CryptoCode, msg: string, opts?: ErrorOptions) {\n    super(code, msg, opts);\n  }\n}\n\nexport class StorageError extends BlindBountyError {\n  constructor(code: StorageCode, msg: string, opts?: ErrorOptions) {\n    super(code, msg, opts);\n  }\n}\n\nexport class ChainError extends BlindBountyError {\n  constructor(code: ChainCode, msg: string, opts?: ErrorOptions) {\n    super(code, msg, opts);\n  }\n}\n\nexport class ComputeError extends BlindBountyError {\n  constructor(code: ComputeCode, msg: string, opts?: ErrorOptions) {\n    super(code, msg, opts);\n  }\n}\n\nexport class ApiError extends BlindBountyError {\n  constructor(code: ApiCode, msg: string, opts?: ErrorOptions) {\n    super(code, msg, opts);\n  }\n}\n\nexport class LifecycleError extends BlindBountyError {\n  constructor(code: LifecycleCode, msg: string, opts?: ErrorOptions) {\n    super(code, msg, opts);\n  }\n}\n\nexport class TimeoutError extends BlindBountyError {\n  constructor(code: TimeoutCode, msg: string, opts?: ErrorOptions) {\n    super(code, msg, opts);\n  }\n}\n","import { ConfigError } from '../errors/index.js';\nimport { networks, type NetworkName } from './presets.js';\nimport type { Network } from './types.js';\n\n/**\n * Resolve a preset name or a literal Network object into the canonical\n * Network used throughout the SDK. Throws ConfigError for unknown names.\n */\nexport function resolveNetwork(arg: NetworkName | Network): Network {\n  if (typeof arg === 'string') {\n    const preset = (networks as Record<string, Network | undefined>)[arg];\n    if (!preset) {\n      const known = Object.keys(networks).join(', ');\n      throw new ConfigError('CONFIG/INVALID_NETWORK', `unknown network '${arg}' (known: ${known})`);\n    }\n    return preset;\n  }\n  return arg;\n}\n"]}

package/dist/network/presets.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Known-good network presets. Addresses pinned per SDK version so upgrading
+ * the SDK cannot silently move contracts under a consumer.
+ *
+ * testnet = 0G Galileo (chainId 16602) — addresses from
+ * contracts/deployments/0g-testnet.json (deployed 2026-04-15).
+ */
+export declare const networks: {
+    readonly testnet: {
+        readonly name: "0g-galileo-testnet";
+        readonly chainId: 16602n;
+        readonly rpc: ["https://evmrpc-testnet.0g.ai"];
+        readonly contracts: {
+            readonly escrow: "0xFd4F93F5A7BE144c405D1D8fbEC63Fb776207681";
+            readonly registry: "0xeE52d780A47F77E8a4a1cEb236e3C65A48FbD828";
+            readonly reputation: "0x4A6374Fae37E19E69ba43E7cf6994AC15F63256e";
+            readonly usdc: "0x317227efcA18D004E12CA8046AEf7E1597458F25";
+        };
+        readonly indexer: "https://indexer-storage-testnet-turbo.0g.ai";
+        readonly broker: "https://broker.testnet.0g.ai";
+        readonly explorer: "https://chainscan-galileo.0g.ai";
+    };
+};
+export type NetworkName = keyof typeof networks;

package/dist/network/presets.js

@@ -0,0 +1,23 @@
+/**
+ * Known-good network presets. Addresses pinned per SDK version so upgrading
+ * the SDK cannot silently move contracts under a consumer.
+ *
+ * testnet = 0G Galileo (chainId 16602) — addresses from
+ * contracts/deployments/0g-testnet.json (deployed 2026-04-15).
+ */
+export const networks = {
+    testnet: {
+        name: '0g-galileo-testnet',
+        chainId: 16602n,
+        rpc: ['https://evmrpc-testnet.0g.ai'],
+        contracts: {
+            escrow: '0xFd4F93F5A7BE144c405D1D8fbEC63Fb776207681',
+            registry: '0xeE52d780A47F77E8a4a1cEb236e3C65A48FbD828',
+            reputation: '0x4A6374Fae37E19E69ba43E7cf6994AC15F63256e',
+            usdc: '0x317227efcA18D004E12CA8046AEf7E1597458F25',
+        },
+        indexer: 'https://indexer-storage-testnet-turbo.0g.ai',
+        broker: 'https://broker.testnet.0g.ai',
+        explorer: 'https://chainscan-galileo.0g.ai',
+    },
+};

package/dist/network/resolve.d.ts

@@ -0,0 +1,7 @@
+import { type NetworkName } from './presets.js';
+import type { Network } from './types.js';
+/**
+ * Resolve a preset name or a literal Network object into the canonical
+ * Network used throughout the SDK. Throws ConfigError for unknown names.
+ */
+export declare function resolveNetwork(arg: NetworkName | Network): Network;

package/dist/network/resolve.js

@@ -0,0 +1,17 @@
+import { ConfigError } from '../errors/index.js';
+import { networks } from './presets.js';
+/**
+ * Resolve a preset name or a literal Network object into the canonical
+ * Network used throughout the SDK. Throws ConfigError for unknown names.
+ */
+export function resolveNetwork(arg) {
+    if (typeof arg === 'string') {
+        const preset = networks[arg];
+        if (!preset) {
+            const known = Object.keys(networks).join(', ');
+            throw new ConfigError('CONFIG/INVALID_NETWORK', `unknown network '${arg}' (known: ${known})`);
+        }
+        return preset;
+    }
+    return arg;
+}

package/dist/network/types.d.ts

@@ -0,0 +1,16 @@
+import type { Address } from '../types.js';
+export interface NetworkContracts {
+    escrow: Address;
+    registry: Address;
+    reputation: Address;
+    usdc: Address;
+}
+export interface Network {
+    name: string;
+    chainId: bigint;
+    rpc: string[];
+    contracts: NetworkContracts;
+    indexer: string;
+    broker: string;
+    explorer?: string;
+}

package/dist/network/types.js

@@ -0,0 +1 @@
+export {};

package/dist/signer/EthersSigner.d.ts

@@ -0,0 +1,24 @@
+import { ethers } from 'ethers';
+import type { Address, Hex } from '../types.js';
+import type { Signer, TxRequest, TypedDataDomain, TypedDataField } from './Signer.js';
+/**
+ * Wraps any ethers v6 Signer. The most common path — accepts ethers.Wallet,
+ * ethers.BrowserProvider signer, JsonRpcSigner, etc. Caches the recovered
+ * public key after the first successful getPublicKey() call.
+ */
+export declare class EthersSigner implements Signer {
+    private readonly inner;
+    private publicKeyCache;
+    constructor(inner: ethers.Signer);
+    getAddress(): Promise<Address>;
+    chainId(): Promise<bigint>;
+    signMessage(msg: string | Uint8Array): Promise<Hex>;
+    signTypedData(domain: TypedDataDomain, types: Record<string, TypedDataField[]>, value: Record<string, unknown>): Promise<Hex>;
+    signTransaction(tx: TxRequest): Promise<Hex>;
+    /**
+     * Recovers the uncompressed secp256k1 public key from the signer. For Wallet
+     * signers we can read it directly; for generic Signers we sign a canonical
+     * probe message once and recover from the signature.
+     */
+    getPublicKey(): Promise<Hex>;
+}

package/dist/signer/EthersSigner.js

@@ -0,0 +1,68 @@
+import { ethers } from 'ethers';
+import { ChainError, ConfigError } from '../errors/index.js';
+/**
+ * Wraps any ethers v6 Signer. The most common path — accepts ethers.Wallet,
+ * ethers.BrowserProvider signer, JsonRpcSigner, etc. Caches the recovered
+ * public key after the first successful getPublicKey() call.
+ */
+export class EthersSigner {
+    inner;
+    publicKeyCache;
+    constructor(inner) {
+        this.inner = inner;
+    }
+    async getAddress() {
+        return (await this.inner.getAddress());
+    }
+    async chainId() {
+        const provider = this.inner.provider;
+        if (!provider) {
+            throw new ConfigError('CONFIG/BAD_CONFIG', 'signer has no attached provider; cannot read chainId');
+        }
+        const net = await provider.getNetwork();
+        return net.chainId;
+    }
+    async signMessage(msg) {
+        return (await this.inner.signMessage(msg));
+    }
+    async signTypedData(domain, types, value) {
+        return (await this.inner.signTypedData(domain, types, value));
+    }
+    async signTransaction(tx) {
+        try {
+            return (await this.inner.signTransaction({
+                to: tx.to,
+                ...(tx.from !== undefined ? { from: tx.from } : {}),
+                ...(tx.data !== undefined ? { data: tx.data } : {}),
+                ...(tx.value !== undefined ? { value: tx.value } : {}),
+                ...(tx.gasLimit !== undefined ? { gasLimit: tx.gasLimit } : {}),
+                ...(tx.nonce !== undefined ? { nonce: tx.nonce } : {}),
+                ...(tx.chainId !== undefined ? { chainId: tx.chainId } : {}),
+            }));
+        }
+        catch (cause) {
+            throw new ChainError('CHAIN/TX_REVERTED', 'signTransaction failed', { cause });
+        }
+    }
+    /**
+     * Recovers the uncompressed secp256k1 public key from the signer. For Wallet
+     * signers we can read it directly; for generic Signers we sign a canonical
+     * probe message once and recover from the signature.
+     */
+    async getPublicKey() {
+        if (this.publicKeyCache)
+            return this.publicKeyCache;
+        // Fast path: ethers.Wallet exposes signingKey.publicKey directly.
+        const maybeWallet = this.inner;
+        if (maybeWallet.signingKey?.publicKey) {
+            this.publicKeyCache = maybeWallet.signingKey.publicKey;
+            return this.publicKeyCache;
+        }
+        // Slow path: sign a probe message and recover the public key.
+        const probe = 'BlindBounty-PublicKey-Recovery-v1';
+        const sig = await this.inner.signMessage(probe);
+        const recovered = ethers.SigningKey.recoverPublicKey(ethers.hashMessage(probe), sig);
+        this.publicKeyCache = recovered;
+        return this.publicKeyCache;
+    }
+}

package/dist/signer/PrivateKeySigner.d.ts

@@ -0,0 +1,14 @@
+import { ethers } from 'ethers';
+import { EthersSigner } from './EthersSigner.js';
+/**
+ * Convenience factory for Node / headless agents: builds an EthersSigner
+ * backed by a fresh ethers.Wallet from a raw private key (hex, with or
+ * without 0x prefix). Optionally attaches an RPC provider so chainId()
+ * and on-chain reads work.
+ *
+ * NEVER pass a private key you don't control — prefer KMS, browser wallet,
+ * or hardware signer for production.
+ */
+export declare class PrivateKeySigner extends EthersSigner {
+    constructor(privateKey: string, provider?: ethers.Provider);
+}

package/dist/signer/PrivateKeySigner.js

@@ -0,0 +1,18 @@
+import { ethers } from 'ethers';
+import { EthersSigner } from './EthersSigner.js';
+/**
+ * Convenience factory for Node / headless agents: builds an EthersSigner
+ * backed by a fresh ethers.Wallet from a raw private key (hex, with or
+ * without 0x prefix). Optionally attaches an RPC provider so chainId()
+ * and on-chain reads work.
+ *
+ * NEVER pass a private key you don't control — prefer KMS, browser wallet,
+ * or hardware signer for production.
+ */
+export class PrivateKeySigner extends EthersSigner {
+    constructor(privateKey, provider) {
+        const pk = privateKey.startsWith('0x') ? privateKey : `0x${privateKey}`;
+        const wallet = provider ? new ethers.Wallet(pk, provider) : new ethers.Wallet(pk);
+        super(wallet);
+    }
+}

package/dist/signer/Signer.d.ts

@@ -0,0 +1,35 @@
+import type { Address, Hex } from '../types.js';
+export interface TxRequest {
+    to: Address;
+    from?: Address;
+    data?: Hex;
+    value?: bigint;
+    gasLimit?: bigint;
+    nonce?: number;
+    chainId?: bigint;
+}
+export interface TypedDataDomain {
+    name?: string;
+    version?: string;
+    chainId?: bigint | number;
+    verifyingContract?: Address;
+    salt?: Hex;
+}
+export type TypedDataField = {
+    name: string;
+    type: string;
+};
+/**
+ * Uniform signing interface used across the SDK. Adapters wrap ethers Signer,
+ * raw private keys, EIP-1193 providers, or KMS. Implementations MUST return
+ * hex-encoded signatures (0x-prefixed) and addresses (0x-prefixed, 20 bytes).
+ */
+export interface Signer {
+    getAddress(): Promise<Address>;
+    chainId(): Promise<bigint>;
+    signMessage(msg: string | Uint8Array): Promise<Hex>;
+    signTypedData(domain: TypedDataDomain, types: Record<string, TypedDataField[]>, value: Record<string, unknown>): Promise<Hex>;
+    signTransaction(tx: TxRequest): Promise<Hex>;
+    /** Uncompressed secp256k1 public key, 0x04-prefixed (hex). */
+    getPublicKey(): Promise<Hex>;
+}

package/dist/signer/Signer.js

@@ -0,0 +1 @@
+export {};

package/dist/signer/index.cjs

@@ -0,0 +1,121 @@
+'use strict';
+
+var ethers = require('ethers');
+
+// src/signer/EthersSigner.ts
+
+// src/errors/BlindBountyError.ts
+var BlindBountyError = class extends Error {
+  code;
+  retriable;
+  context;
+  cause;
+  constructor(code, message, opts = {}) {
+    super(message);
+    this.code = code;
+    this.retriable = opts.retriable ?? false;
+    if (opts.context !== void 0) this.context = opts.context;
+    if (opts.cause !== void 0) this.cause = opts.cause;
+    Object.defineProperty(this, "name", {
+      value: this.constructor.name,
+      enumerable: false,
+      configurable: true,
+      writable: true
+    });
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      code: this.code,
+      message: this.message,
+      retriable: this.retriable,
+      ...this.context ? { context: this.context } : {}
+    };
+  }
+};
+
+// src/errors/subclasses.ts
+var ConfigError = class extends BlindBountyError {
+  constructor(code, msg, opts) {
+    super(code, msg, opts);
+  }
+};
+var ChainError = class extends BlindBountyError {
+  constructor(code, msg, opts) {
+    super(code, msg, opts);
+  }
+};
+
+// src/signer/EthersSigner.ts
+var EthersSigner = class {
+  constructor(inner) {
+    this.inner = inner;
+  }
+  inner;
+  publicKeyCache;
+  async getAddress() {
+    return await this.inner.getAddress();
+  }
+  async chainId() {
+    const provider = this.inner.provider;
+    if (!provider) {
+      throw new ConfigError("CONFIG/BAD_CONFIG", "signer has no attached provider; cannot read chainId");
+    }
+    const net = await provider.getNetwork();
+    return net.chainId;
+  }
+  async signMessage(msg) {
+    return await this.inner.signMessage(msg);
+  }
+  async signTypedData(domain, types, value) {
+    return await this.inner.signTypedData(domain, types, value);
+  }
+  async signTransaction(tx) {
+    try {
+      return await this.inner.signTransaction({
+        to: tx.to,
+        ...tx.from !== void 0 ? { from: tx.from } : {},
+        ...tx.data !== void 0 ? { data: tx.data } : {},
+        ...tx.value !== void 0 ? { value: tx.value } : {},
+        ...tx.gasLimit !== void 0 ? { gasLimit: tx.gasLimit } : {},
+        ...tx.nonce !== void 0 ? { nonce: tx.nonce } : {},
+        ...tx.chainId !== void 0 ? { chainId: tx.chainId } : {}
+      });
+    } catch (cause) {
+      throw new ChainError("CHAIN/TX_REVERTED", "signTransaction failed", { cause });
+    }
+  }
+  /**
+   * Recovers the uncompressed secp256k1 public key from the signer. For Wallet
+   * signers we can read it directly; for generic Signers we sign a canonical
+   * probe message once and recover from the signature.
+   */
+  async getPublicKey() {
+    if (this.publicKeyCache) return this.publicKeyCache;
+    const maybeWallet = this.inner;
+    if (maybeWallet.signingKey?.publicKey) {
+      this.publicKeyCache = maybeWallet.signingKey.publicKey;
+      return this.publicKeyCache;
+    }
+    const probe = "BlindBounty-PublicKey-Recovery-v1";
+    const sig = await this.inner.signMessage(probe);
+    const recovered = ethers.ethers.SigningKey.recoverPublicKey(
+      ethers.ethers.hashMessage(probe),
+      sig
+    );
+    this.publicKeyCache = recovered;
+    return this.publicKeyCache;
+  }
+};
+var PrivateKeySigner = class extends EthersSigner {
+  constructor(privateKey, provider) {
+    const pk = privateKey.startsWith("0x") ? privateKey : `0x${privateKey}`;
+    const wallet = provider ? new ethers.ethers.Wallet(pk, provider) : new ethers.ethers.Wallet(pk);
+    super(wallet);
+  }
+};
+
+exports.EthersSigner = EthersSigner;
+exports.PrivateKeySigner = PrivateKeySigner;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/signer/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/errors/BlindBountyError.ts","../../src/errors/subclasses.ts","../../src/signer/EthersSigner.ts","../../src/signer/PrivateKeySigner.ts"],"names":["ethers"],"mappings":";;;;;;;AAQO,IAAe,gBAAA,GAAf,cAAwC,KAAA,CAAM;AAAA,EAC1C,IAAA;AAAA,EACA,SAAA;AAAA,EACA,OAAA;AAAA,EACS,KAAA;AAAA,EAElB,WAAA,CAAY,IAAA,EAAiB,OAAA,EAAiB,IAAA,GAAqB,EAAC,EAAG;AACrE,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AACZ,IAAA,IAAA,CAAK,SAAA,GAAY,KAAK,SAAA,IAAa,KAAA;AACnC,IAAA,IAAI,IAAA,CAAK,OAAA,KAAY,MAAA,EAAW,IAAA,CAAK,UAAU,IAAA,CAAK,OAAA;AACpD,IAAA,IAAI,IAAA,CAAK,KAAA,KAAU,MAAA,EAAW,IAAA,CAAK,QAAQ,IAAA,CAAK,KAAA;AAChD,IAAA,MAAA,CAAO,cAAA,CAAe,MAAM,MAAA,EAAQ;AAAA,MAClC,KAAA,EAAO,KAAK,WAAA,CAAY,IAAA;AAAA,MACxB,UAAA,EAAY,KAAA;AAAA,MACZ,YAAA,EAAc,IAAA;AAAA,MACd,QAAA,EAAU;AAAA,KACX,CAAA;AAAA,EACH;AAAA,EAEA,MAAA,GAAkC;AAChC,IAAA,OAAO;AAAA,MACL,MAAM,IAAA,CAAK,IAAA;AAAA,MACX,MAAM,IAAA,CAAK,IAAA;AAAA,MACX,SAAS,IAAA,CAAK,OAAA;AAAA,MACd,WAAW,IAAA,CAAK,SAAA;AAAA,MAChB,GAAI,KAAK,OAAA,GAAU,EAAE,SAAS,IAAA,CAAK,OAAA,KAAY;AAAC,KAClD;AAAA,EACF;AACF,CAAA;;;ACzBO,IAAM,WAAA,GAAN,cAA0B,gBAAA,CAAiB;AAAA,EAChD,WAAA,CAAY,IAAA,EAAkB,GAAA,EAAa,IAAA,EAAqB;AAC9D,IAAA,KAAA,CAAM,IAAA,EAAM,KAAK,IAAI,CAAA;AAAA,EACvB;AACF,CAAA;AAcO,IAAM,UAAA,GAAN,cAAyB,gBAAA,CAAiB;AAAA,EAC/C,WAAA,CAAY,IAAA,EAAiB,GAAA,EAAa,IAAA,EAAqB;AAC7D,IAAA,KAAA,CAAM,IAAA,EAAM,KAAK,IAAI,CAAA;AAAA,EACvB;AACF,CAAA;;;ACxBO,IAAM,eAAN,MAAqC;AAAA,EAG1C,YAA6B,KAAA,EAAsB;AAAtB,IAAA,IAAA,CAAA,KAAA,GAAA,KAAA;AAAA,EAAuB;AAAA,EAAvB,KAAA;AAAA,EAFrB,cAAA;AAAA,EAIR,MAAM,UAAA,GAA+B;AACnC,IAAA,OAAQ,MAAM,IAAA,CAAK,KAAA,CAAM,UAAA,EAAW;AAAA,EACtC;AAAA,EAEA,MAAM,OAAA,GAA2B;AAC/B,IAAA,MAAM,QAAA,GAAW,KAAK,KAAA,CAAM,QAAA;AAC5B,IAAA,IAAI,CAAC,QAAA,EAAU;AACb,MAAA,MAAM,IAAI,WAAA,CAAY,mBAAA,EAAqB,sDAAsD,CAAA;AAAA,IACnG;AACA,IAAA,MAAM,GAAA,GAAM,MAAM,QAAA,CAAS,UAAA,EAAW;AACtC,IAAA,OAAO,GAAA,CAAI,OAAA;AAAA,EACb;AAAA,EAEA,MAAM,YAAY,GAAA,EAAwC;AACxD,IAAA,OAAQ,MAAM,IAAA,CAAK,KAAA,CAAM,WAAA,CAAY,GAAG,CAAA;AAAA,EAC1C;AAAA,EAEA,MAAM,aAAA,CACJ,MAAA,EACA,KAAA,EACA,KAAA,EACc;AACd,IAAA,OAAQ,MAAM,IAAA,CAAK,KAAA,CAAM,aAAA,CAAc,MAAA,EAAQ,OAAO,KAAK,CAAA;AAAA,EAC7D;AAAA,EAEA,MAAM,gBAAgB,EAAA,EAA6B;AACjD,IAAA,IAAI;AACF,MAAA,OAAQ,MAAM,IAAA,CAAK,KAAA,CAAM,eAAA,CAAgB;AAAA,QACvC,IAAI,EAAA,CAAG,EAAA;AAAA,QACP,GAAI,GAAG,IAAA,KAAS,KAAA,CAAA,GAAY,EAAE,IAAA,EAAM,EAAA,CAAG,IAAA,EAAK,GAAI,EAAC;AAAA,QACjD,GAAI,GAAG,IAAA,KAAS,KAAA,CAAA,GAAY,EAAE,IAAA,EAAM,EAAA,CAAG,IAAA,EAAK,GAAI,EAAC;AAAA,QACjD,GAAI,GAAG,KAAA,KAAU,KAAA,CAAA,GAAY,EAAE,KAAA,EAAO,EAAA,CAAG,KAAA,EAAM,GAAI,EAAC;AAAA,QACpD,GAAI,GAAG,QAAA,KAAa,KAAA,CAAA,GAAY,EAAE,QAAA,EAAU,EAAA,CAAG,QAAA,EAAS,GAAI,EAAC;AAAA,QAC7D,GAAI,GAAG,KAAA,KAAU,KAAA,CAAA,GAAY,EAAE,KAAA,EAAO,EAAA,CAAG,KAAA,EAAM,GAAI,EAAC;AAAA,QACpD,GAAI,GAAG,OAAA,KAAY,KAAA,CAAA,GAAY,EAAE,OAAA,EAAS,EAAA,CAAG,OAAA,EAAQ,GAAI;AAAC,OAC3D,CAAA;AAAA,IACH,SAAS,KAAA,EAAO;AACd,MAAA,MAAM,IAAI,UAAA,CAAW,mBAAA,EAAqB,wBAAA,EAA0B,EAAE,OAAO,CAAA;AAAA,IAC/E;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,YAAA,GAA6B;AACjC,IAAA,IAAI,IAAA,CAAK,cAAA,EAAgB,OAAO,IAAA,CAAK,cAAA;AAGrC,IAAA,MAAM,cAAc,IAAA,CAAK,KAAA;AACzB,IAAA,IAAI,WAAA,CAAY,YAAY,SAAA,EAAW;AACrC,MAAA,IAAA,CAAK,cAAA,GAAiB,YAAY,UAAA,CAAW,SAAA;AAC7C,MAAA,OAAO,IAAA,CAAK,cAAA;AAAA,IACd;AAGA,IAAA,MAAM,KAAA,GAAQ,mCAAA;AACd,IAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,KAAA,CAAM,YAAY,KAAK,CAAA;AAC9C,IAAA,MAAM,SAAA,GAAYA,cAAO,UAAA,CAAW,gBAAA;AAAA,MAClCA,aAAA,CAAO,YAAY,KAAK,CAAA;AAAA,MACxB;AAAA,KACF;AACA,IAAA,IAAA,CAAK,cAAA,GAAiB,SAAA;AACtB,IAAA,OAAO,IAAA,CAAK,cAAA;AAAA,EACd;AACF;ACrEO,IAAM,gBAAA,GAAN,cAA+B,YAAA,CAAa;AAAA,EACjD,WAAA,CAAY,YAAoB,QAAA,EAA4B;AAC1D,IAAA,MAAM,KAAK,UAAA,CAAW,UAAA,CAAW,IAAI,CAAA,GAAI,UAAA,GAAa,KAAK,UAAU,CAAA,CAAA;AACrE,IAAA,MAAM,MAAA,GAAS,QAAA,GAAW,IAAIA,aAAAA,CAAO,MAAA,CAAO,EAAA,EAAI,QAAQ,CAAA,GAAI,IAAIA,aAAAA,CAAO,MAAA,CAAO,EAAE,CAAA;AAChF,IAAA,KAAA,CAAM,MAAM,CAAA;AAAA,EACd;AACF","file":"index.cjs","sourcesContent":["import type { ErrorCode } from './codes.js';\n\nexport interface ErrorOptions {\n  retriable?: boolean;\n  context?: Record<string, unknown>;\n  cause?: unknown;\n}\n\nexport abstract class BlindBountyError extends Error {\n  readonly code: ErrorCode;\n  readonly retriable: boolean;\n  readonly context?: Record<string, unknown>;\n  override readonly cause?: unknown;\n\n  constructor(code: ErrorCode, message: string, opts: ErrorOptions = {}) {\n    super(message);\n    this.code = code;\n    this.retriable = opts.retriable ?? false;\n    if (opts.context !== undefined) this.context = opts.context;\n    if (opts.cause !== undefined) this.cause = opts.cause;\n    Object.defineProperty(this, 'name', {\n      value: this.constructor.name,\n      enumerable: false,\n      configurable: true,\n      writable: true,\n    });\n  }\n\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      code: this.code,\n      message: this.message,\n      retriable: this.retriable,\n      ...(this.context ? { context: this.context } : {}),\n    };\n  }\n}\n","import { BlindBountyError, type ErrorOptions } from './BlindBountyError.js';\nimport type {\n  ApiCode,\n  ChainCode,\n  ComputeCode,\n  ConfigCode,\n  CryptoCode,\n  LifecycleCode,\n  StorageCode,\n  TimeoutCode,\n} from './codes.js';\n\nexport class ConfigError extends BlindBountyError {\n  constructor(code: ConfigCode, msg: string, opts?: ErrorOptions) {\n    super(code, msg, opts);\n  }\n}\n\nexport class CryptoError extends BlindBountyError {\n  constructor(code: CryptoCode, msg: string, opts?: ErrorOptions) {\n    super(code, msg, opts);\n  }\n}\n\nexport class StorageError extends BlindBountyError {\n  constructor(code: StorageCode, msg: string, opts?: ErrorOptions) {\n    super(code, msg, opts);\n  }\n}\n\nexport class ChainError extends BlindBountyError {\n  constructor(code: ChainCode, msg: string, opts?: ErrorOptions) {\n    super(code, msg, opts);\n  }\n}\n\nexport class ComputeError extends BlindBountyError {\n  constructor(code: ComputeCode, msg: string, opts?: ErrorOptions) {\n    super(code, msg, opts);\n  }\n}\n\nexport class ApiError extends BlindBountyError {\n  constructor(code: ApiCode, msg: string, opts?: ErrorOptions) {\n    super(code, msg, opts);\n  }\n}\n\nexport class LifecycleError extends BlindBountyError {\n  constructor(code: LifecycleCode, msg: string, opts?: ErrorOptions) {\n    super(code, msg, opts);\n  }\n}\n\nexport class TimeoutError extends BlindBountyError {\n  constructor(code: TimeoutCode, msg: string, opts?: ErrorOptions) {\n    super(code, msg, opts);\n  }\n}\n","import { ethers } from 'ethers';\nimport { ChainError, ConfigError } from '../errors/index.js';\nimport type { Address, Hex } from '../types.js';\nimport type { Signer, TxRequest, TypedDataDomain, TypedDataField } from './Signer.js';\n\n/**\n * Wraps any ethers v6 Signer. The most common path — accepts ethers.Wallet,\n * ethers.BrowserProvider signer, JsonRpcSigner, etc. Caches the recovered\n * public key after the first successful getPublicKey() call.\n */\nexport class EthersSigner implements Signer {\n  private publicKeyCache: Hex | undefined;\n\n  constructor(private readonly inner: ethers.Signer) {}\n\n  async getAddress(): Promise<Address> {\n    return (await this.inner.getAddress()) as Address;\n  }\n\n  async chainId(): Promise<bigint> {\n    const provider = this.inner.provider;\n    if (!provider) {\n      throw new ConfigError('CONFIG/BAD_CONFIG', 'signer has no attached provider; cannot read chainId');\n    }\n    const net = await provider.getNetwork();\n    return net.chainId;\n  }\n\n  async signMessage(msg: string | Uint8Array): Promise<Hex> {\n    return (await this.inner.signMessage(msg)) as Hex;\n  }\n\n  async signTypedData(\n    domain: TypedDataDomain,\n    types: Record<string, TypedDataField[]>,\n    value: Record<string, unknown>,\n  ): Promise<Hex> {\n    return (await this.inner.signTypedData(domain, types, value)) as Hex;\n  }\n\n  async signTransaction(tx: TxRequest): Promise<Hex> {\n    try {\n      return (await this.inner.signTransaction({\n        to: tx.to,\n        ...(tx.from !== undefined ? { from: tx.from } : {}),\n        ...(tx.data !== undefined ? { data: tx.data } : {}),\n        ...(tx.value !== undefined ? { value: tx.value } : {}),\n        ...(tx.gasLimit !== undefined ? { gasLimit: tx.gasLimit } : {}),\n        ...(tx.nonce !== undefined ? { nonce: tx.nonce } : {}),\n        ...(tx.chainId !== undefined ? { chainId: tx.chainId } : {}),\n      })) as Hex;\n    } catch (cause) {\n      throw new ChainError('CHAIN/TX_REVERTED', 'signTransaction failed', { cause });\n    }\n  }\n\n  /**\n   * Recovers the uncompressed secp256k1 public key from the signer. For Wallet\n   * signers we can read it directly; for generic Signers we sign a canonical\n   * probe message once and recover from the signature.\n   */\n  async getPublicKey(): Promise<Hex> {\n    if (this.publicKeyCache) return this.publicKeyCache;\n\n    // Fast path: ethers.Wallet exposes signingKey.publicKey directly.\n    const maybeWallet = this.inner as unknown as { signingKey?: { publicKey: string } };\n    if (maybeWallet.signingKey?.publicKey) {\n      this.publicKeyCache = maybeWallet.signingKey.publicKey as Hex;\n      return this.publicKeyCache;\n    }\n\n    // Slow path: sign a probe message and recover the public key.\n    const probe = 'BlindBounty-PublicKey-Recovery-v1';\n    const sig = await this.inner.signMessage(probe);\n    const recovered = ethers.SigningKey.recoverPublicKey(\n      ethers.hashMessage(probe),\n      sig,\n    );\n    this.publicKeyCache = recovered as Hex;\n    return this.publicKeyCache;\n  }\n}\n","import { ethers } from 'ethers';\nimport { EthersSigner } from './EthersSigner.js';\n\n/**\n * Convenience factory for Node / headless agents: builds an EthersSigner\n * backed by a fresh ethers.Wallet from a raw private key (hex, with or\n * without 0x prefix). Optionally attaches an RPC provider so chainId()\n * and on-chain reads work.\n *\n * NEVER pass a private key you don't control — prefer KMS, browser wallet,\n * or hardware signer for production.\n */\nexport class PrivateKeySigner extends EthersSigner {\n  constructor(privateKey: string, provider?: ethers.Provider) {\n    const pk = privateKey.startsWith('0x') ? privateKey : `0x${privateKey}`;\n    const wallet = provider ? new ethers.Wallet(pk, provider) : new ethers.Wallet(pk);\n    super(wallet);\n  }\n}\n"]}

package/dist/signer/index.d.cts

@@ -0,0 +1,40 @@
+import { S as Signer, T as TypedDataDomain, a as TypedDataField, b as TxRequest } from '../Signer-BnqH_qew.cjs';
+import { ethers } from 'ethers';
+import { A as Address, H as Hex } from '../types-BOG5Ub1z.cjs';
+
+/**
+ * Wraps any ethers v6 Signer. The most common path — accepts ethers.Wallet,
+ * ethers.BrowserProvider signer, JsonRpcSigner, etc. Caches the recovered
+ * public key after the first successful getPublicKey() call.
+ */
+declare class EthersSigner implements Signer {
+    private readonly inner;
+    private publicKeyCache;
+    constructor(inner: ethers.Signer);
+    getAddress(): Promise<Address>;
+    chainId(): Promise<bigint>;
+    signMessage(msg: string | Uint8Array): Promise<Hex>;
+    signTypedData(domain: TypedDataDomain, types: Record<string, TypedDataField[]>, value: Record<string, unknown>): Promise<Hex>;
+    signTransaction(tx: TxRequest): Promise<Hex>;
+    /**
+     * Recovers the uncompressed secp256k1 public key from the signer. For Wallet
+     * signers we can read it directly; for generic Signers we sign a canonical
+     * probe message once and recover from the signature.
+     */
+    getPublicKey(): Promise<Hex>;
+}
+
+/**
+ * Convenience factory for Node / headless agents: builds an EthersSigner
+ * backed by a fresh ethers.Wallet from a raw private key (hex, with or
+ * without 0x prefix). Optionally attaches an RPC provider so chainId()
+ * and on-chain reads work.
+ *
+ * NEVER pass a private key you don't control — prefer KMS, browser wallet,
+ * or hardware signer for production.
+ */
+declare class PrivateKeySigner extends EthersSigner {
+    constructor(privateKey: string, provider?: ethers.Provider);
+}
+
+export { EthersSigner, PrivateKeySigner, Signer, TxRequest, TypedDataDomain, TypedDataField };

package/dist/signer/index.d.ts

@@ -0,0 +1,3 @@
+export * from './Signer.js';
+export * from './EthersSigner.js';
+export * from './PrivateKeySigner.js';

package/dist/signer/index.js

@@ -0,0 +1,3 @@
+export * from './Signer.js';
+export * from './EthersSigner.js';
+export * from './PrivateKeySigner.js';

package/dist/signer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/errors/BlindBountyError.ts","../../src/errors/subclasses.ts","../../src/signer/EthersSigner.ts","../../src/signer/PrivateKeySigner.ts"],"names":["ethers"],"mappings":"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","file":"index.js","sourcesContent":["import type { ErrorCode } from './codes.js';\n\nexport interface ErrorOptions {\n  retriable?: boolean;\n  context?: Record<string, unknown>;\n  cause?: unknown;\n}\n\nexport abstract class BlindBountyError extends Error {\n  readonly code: ErrorCode;\n  readonly retriable: boolean;\n  readonly context?: Record<string, unknown>;\n  override readonly cause?: unknown;\n\n  constructor(code: ErrorCode, message: string, opts: ErrorOptions = {}) {\n    super(message);\n    this.code = code;\n    this.retriable = opts.retriable ?? false;\n    if (opts.context !== undefined) this.context = opts.context;\n    if (opts.cause !== undefined) this.cause = opts.cause;\n    Object.defineProperty(this, 'name', {\n      value: this.constructor.name,\n      enumerable: false,\n      configurable: true,\n      writable: true,\n    });\n  }\n\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      code: this.code,\n      message: this.message,\n      retriable: this.retriable,\n      ...(this.context ? { context: this.context } : {}),\n    };\n  }\n}\n","import { BlindBountyError, type ErrorOptions } from './BlindBountyError.js';\nimport type {\n  ApiCode,\n  ChainCode,\n  ComputeCode,\n  ConfigCode,\n  CryptoCode,\n  LifecycleCode,\n  StorageCode,\n  TimeoutCode,\n} from './codes.js';\n\nexport class ConfigError extends BlindBountyError {\n  constructor(code: ConfigCode, msg: string, opts?: ErrorOptions) {\n    super(code, msg, opts);\n  }\n}\n\nexport class CryptoError extends BlindBountyError {\n  constructor(code: CryptoCode, msg: string, opts?: ErrorOptions) {\n    super(code, msg, opts);\n  }\n}\n\nexport class StorageError extends BlindBountyError {\n  constructor(code: StorageCode, msg: string, opts?: ErrorOptions) {\n    super(code, msg, opts);\n  }\n}\n\nexport class ChainError extends BlindBountyError {\n  constructor(code: ChainCode, msg: string, opts?: ErrorOptions) {\n    super(code, msg, opts);\n  }\n}\n\nexport class ComputeError extends BlindBountyError {\n  constructor(code: ComputeCode, msg: string, opts?: ErrorOptions) {\n    super(code, msg, opts);\n  }\n}\n\nexport class ApiError extends BlindBountyError {\n  constructor(code: ApiCode, msg: string, opts?: ErrorOptions) {\n    super(code, msg, opts);\n  }\n}\n\nexport class LifecycleError extends BlindBountyError {\n  constructor(code: LifecycleCode, msg: string, opts?: ErrorOptions) {\n    super(code, msg, opts);\n  }\n}\n\nexport class TimeoutError extends BlindBountyError {\n  constructor(code: TimeoutCode, msg: string, opts?: ErrorOptions) {\n    super(code, msg, opts);\n  }\n}\n","import { ethers } from 'ethers';\nimport { ChainError, ConfigError } from '../errors/index.js';\nimport type { Address, Hex } from '../types.js';\nimport type { Signer, TxRequest, TypedDataDomain, TypedDataField } from './Signer.js';\n\n/**\n * Wraps any ethers v6 Signer. The most common path — accepts ethers.Wallet,\n * ethers.BrowserProvider signer, JsonRpcSigner, etc. Caches the recovered\n * public key after the first successful getPublicKey() call.\n */\nexport class EthersSigner implements Signer {\n  private publicKeyCache: Hex | undefined;\n\n  constructor(private readonly inner: ethers.Signer) {}\n\n  async getAddress(): Promise<Address> {\n    return (await this.inner.getAddress()) as Address;\n  }\n\n  async chainId(): Promise<bigint> {\n    const provider = this.inner.provider;\n    if (!provider) {\n      throw new ConfigError('CONFIG/BAD_CONFIG', 'signer has no attached provider; cannot read chainId');\n    }\n    const net = await provider.getNetwork();\n    return net.chainId;\n  }\n\n  async signMessage(msg: string | Uint8Array): Promise<Hex> {\n    return (await this.inner.signMessage(msg)) as Hex;\n  }\n\n  async signTypedData(\n    domain: TypedDataDomain,\n    types: Record<string, TypedDataField[]>,\n    value: Record<string, unknown>,\n  ): Promise<Hex> {\n    return (await this.inner.signTypedData(domain, types, value)) as Hex;\n  }\n\n  async signTransaction(tx: TxRequest): Promise<Hex> {\n    try {\n      return (await this.inner.signTransaction({\n        to: tx.to,\n        ...(tx.from !== undefined ? { from: tx.from } : {}),\n        ...(tx.data !== undefined ? { data: tx.data } : {}),\n        ...(tx.value !== undefined ? { value: tx.value } : {}),\n        ...(tx.gasLimit !== undefined ? { gasLimit: tx.gasLimit } : {}),\n        ...(tx.nonce !== undefined ? { nonce: tx.nonce } : {}),\n        ...(tx.chainId !== undefined ? { chainId: tx.chainId } : {}),\n      })) as Hex;\n    } catch (cause) {\n      throw new ChainError('CHAIN/TX_REVERTED', 'signTransaction failed', { cause });\n    }\n  }\n\n  /**\n   * Recovers the uncompressed secp256k1 public key from the signer. For Wallet\n   * signers we can read it directly; for generic Signers we sign a canonical\n   * probe message once and recover from the signature.\n   */\n  async getPublicKey(): Promise<Hex> {\n    if (this.publicKeyCache) return this.publicKeyCache;\n\n    // Fast path: ethers.Wallet exposes signingKey.publicKey directly.\n    const maybeWallet = this.inner as unknown as { signingKey?: { publicKey: string } };\n    if (maybeWallet.signingKey?.publicKey) {\n      this.publicKeyCache = maybeWallet.signingKey.publicKey as Hex;\n      return this.publicKeyCache;\n    }\n\n    // Slow path: sign a probe message and recover the public key.\n    const probe = 'BlindBounty-PublicKey-Recovery-v1';\n    const sig = await this.inner.signMessage(probe);\n    const recovered = ethers.SigningKey.recoverPublicKey(\n      ethers.hashMessage(probe),\n      sig,\n    );\n    this.publicKeyCache = recovered as Hex;\n    return this.publicKeyCache;\n  }\n}\n","import { ethers } from 'ethers';\nimport { EthersSigner } from './EthersSigner.js';\n\n/**\n * Convenience factory for Node / headless agents: builds an EthersSigner\n * backed by a fresh ethers.Wallet from a raw private key (hex, with or\n * without 0x prefix). Optionally attaches an RPC provider so chainId()\n * and on-chain reads work.\n *\n * NEVER pass a private key you don't control — prefer KMS, browser wallet,\n * or hardware signer for production.\n */\nexport class PrivateKeySigner extends EthersSigner {\n  constructor(privateKey: string, provider?: ethers.Provider) {\n    const pk = privateKey.startsWith('0x') ? privateKey : `0x${privateKey}`;\n    const wallet = provider ? new ethers.Wallet(pk, provider) : new ethers.Wallet(pk);\n    super(wallet);\n  }\n}\n"]}