@bind-protocol/sdk 0.2.0

package/README.md

@@ -0,0 +1,309 @@
+# @bind-protocol/sdk
+
+TypeScript SDK for the **Bind Protocol** - privacy-preserving credential issuance and verification using zero-knowledge proofs.
+
+## Installation
+
+```bash
+npm install @bind-protocol/sdk
+```
+
+## Quick Start
+
+```typescript
+import { BindClient } from '@bind-protocol/sdk';
+
+const client = new BindClient({
+  apiKey: 'your-api-key',
+});
+
+// Submit a prove job
+const result = await client.submitProveJob('bind.mobility.riskband.v1', {
+  signals: JSON.stringify(telemetryData),
+  timestamp: new Date().toISOString(),
+});
+
+// Wait for completion
+const job = await client.waitForProveJob(result.data.jobId);
+
+if (job.status === 'completed') {
+  console.log('Proof generated:', job.attestationId);
+}
+```
+
+## Architecture
+
+The SDK is organized into modules:
+
+```
+@bind-protocol/sdk
+├── core/           # Main client, types, and errors
+│   ├── BindClient  # API client for prove jobs and policies
+│   ├── types       # TypeScript type definitions
+│   └── errors      # Custom error classes
+└── adapters/       # Data source adapters
+    └── dimo/       # DIMO Network integration
+```
+
+### Import Paths
+
+```typescript
+// Main entry point (recommended)
+import { BindClient, DimoAdapter } from '@bind-protocol/sdk';
+
+// Or import specific modules
+import { BindClient } from '@bind-protocol/sdk/core';
+import { DimoAdapter } from '@bind-protocol/sdk/adapters/dimo';
+```
+
+## Core Module
+
+### BindClient
+
+The main client for interacting with the Bind Protocol API.
+
+```typescript
+import { BindClient } from '@bind-protocol/sdk';
+
+const client = new BindClient({
+  apiKey: 'your-api-key',
+  baseUrl: 'https://api.bindprotocol.com', // optional
+});
+```
+
+#### Methods
+
+| Method | Description |
+|--------|-------------|
+| `submitProveJob(circuitId, inputs)` | Submit a prove job for async processing |
+| `getProveJob(jobId)` | Get status and results of a prove job |
+| `listProveJobs(options?)` | List prove jobs with optional filters |
+| `waitForProveJob(jobId, options?)` | Poll until job completes or fails |
+| `listPolicies()` | List all public policies (no auth required) |
+| `getPolicy(policyId)` | Get a specific policy by ID |
+
+### Error Handling
+
+The SDK provides typed errors for common scenarios:
+
+```typescript
+import {
+  BindError,
+  ApiError,
+  AuthenticationError,
+  TimeoutError,
+  InsufficientCreditsError
+} from '@bind-protocol/sdk';
+
+try {
+  await client.submitProveJob(circuitId, inputs);
+} catch (error) {
+  if (error instanceof InsufficientCreditsError) {
+    console.log(`Need ${error.required} credits, have ${error.available}`);
+  } else if (error instanceof AuthenticationError) {
+    console.log('Invalid API key');
+  } else if (error instanceof TimeoutError) {
+    console.log(`Timed out after ${error.timeoutMs}ms`);
+  }
+}
+```
+
+## Adapters
+
+Adapters abstract data sources and transform their data into circuit inputs.
+
+### DIMO Adapter
+
+Fetches vehicle telemetry from the [DIMO Network](https://dimo.zone) and transforms it for risk band evaluation.
+
+```typescript
+import { BindClient, DimoAdapter } from '@bind-protocol/sdk';
+import { DIMO } from '@dimo-network/data-sdk';
+
+// Initialize DIMO client (see DIMO docs for auth)
+const dimoClient = new DIMO('Production');
+await dimoClient.auth.getToken({ /* ... */ });
+
+// Create adapter
+const dimo = new DimoAdapter({ dimoClient });
+
+// Fetch telemetry
+const data = await dimo.fetchData({
+  vehicleTokenId: '12345',
+  from: '2024-01-01',
+  to: '2024-01-31',
+});
+
+// Transform to circuit inputs
+const inputs = dimo.toCircuitInputs(data, 'bind.mobility.riskband.v1');
+
+// Submit prove job
+const client = new BindClient({ apiKey: 'your-api-key' });
+const result = await client.submitProveJob('bind.mobility.riskband.v1', inputs);
+```
+
+### Creating Custom Adapters
+
+Implement the `DataAdapter` interface to create adapters for other data sources:
+
+```typescript
+import type { DataAdapter, ProveJobInputs } from '@bind-protocol/sdk';
+
+interface MyDataQuery {
+  userId: string;
+  dateRange: { from: string; to: string };
+}
+
+interface MyData {
+  metrics: number[];
+  timestamp: string;
+}
+
+class MyAdapter implements DataAdapter<MyConfig, MyDataQuery, MyData> {
+  readonly id = 'my-adapter';
+  readonly name = 'My Data Source';
+  readonly description = 'Fetches data from my service';
+
+  async fetchData(query: MyDataQuery): Promise<MyData> {
+    // Fetch from your data source
+  }
+
+  toCircuitInputs(data: MyData, circuitId: string): ProveJobInputs {
+    // Transform to circuit inputs
+    return {
+      metrics: JSON.stringify(data.metrics),
+      timestamp: data.timestamp,
+    };
+  }
+}
+```
+
+## Policies and Circuits
+
+### Understanding Policies
+
+A **Policy** defines what data is evaluated and what credentials are issued:
+
+- Input specifications (what data is needed)
+- Evaluation rules (how data is scored/validated)
+- Output claims (what the credential asserts)
+- Privacy controls (what verifiers can see)
+
+### Understanding Circuits
+
+A **Circuit** is the zero-knowledge proof implementation that cryptographically proves a policy was evaluated correctly without revealing the underlying data.
+
+```typescript
+// List available policies
+const policies = await client.listPolicies();
+
+for (const policy of policies) {
+  console.log(`${policy.id}: ${policy.metadata.title}`);
+  console.log(`  Outputs: ${policy.outputs.map(o => o.name).join(', ')}`);
+}
+
+// Get policy details
+const policy = await client.getPolicy('bind.mobility.riskband.v1');
+console.log(policy.outputs); // [{ name: 'riskBand', type: 'enum', ... }]
+```
+
+## Complete Example: Insurance Risk Assessment
+
+```typescript
+import { BindClient, DimoAdapter } from '@bind-protocol/sdk';
+import { DIMO } from '@dimo-network/data-sdk';
+
+async function generateRiskCredential(vehicleTokenId: string) {
+  // 1. Set up clients
+  const dimoClient = new DIMO('Production');
+  await dimoClient.auth.getToken({ /* ... */ });
+
+  const dimo = new DimoAdapter({ dimoClient });
+  const bind = new BindClient({ apiKey: process.env.BIND_API_KEY });
+
+  // 2. Fetch 30 days of telemetry
+  const telemetry = await dimo.fetchData({
+    vehicleTokenId,
+    from: '2024-12-01',
+    to: '2024-12-31',
+  });
+
+  // 3. Transform and submit prove job
+  const inputs = dimo.toCircuitInputs(telemetry, 'bind.mobility.riskband.v1');
+  const result = await bind.submitProveJob('bind.mobility.riskband.v1', inputs);
+
+  if (!result.success) {
+    throw new Error(result.error);
+  }
+
+  // 4. Wait for proof generation
+  const job = await bind.waitForProveJob(result.data.jobId, {
+    onProgress: (j) => console.log(`Status: ${j.status}`),
+  });
+
+  if (job.status !== 'completed') {
+    throw new Error(job.error || 'Proof generation failed');
+  }
+
+  // 5. Return credential
+  return {
+    policyId: 'bind.mobility.riskband.v1',
+    attestationId: job.attestationId,
+    zkVerifyTxHash: job.zkVerifyTxHash,
+  };
+}
+```
+
+## Types
+
+All types are exported from the main package:
+
+```typescript
+import type {
+  // Client options
+  BindClientOptions,
+
+  // Prove job types
+  ProveJobStatus,
+  ProveJobInputs,
+  ProveJob,
+  ProveJobSummary,
+  SubmitProveJobResponse,
+  GetProveJobResponse,
+  ListProveJobsOptions,
+  ListProveJobsResponse,
+
+  // Credential types
+  BindCredential,
+
+  // Policy types (from @bind-protocol/policy-spec)
+  PublicPolicySpec,
+  PolicyId,
+  PolicyMetadata,
+
+  // Adapter types
+  DataAdapter,
+  TelemetryData,
+
+  // DIMO types
+  DimoAdapterConfig,
+  DimoQuery,
+  DimoTelemetryData,
+} from '@bind-protocol/sdk';
+```
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `BIND_API_URL` | API base URL | `https://api.bindprotocol.com` |
+
+## License
+
+MIT
+
+## Links
+
+- [Bind Protocol](https://bindprotocol.com)
+- [Documentation](https://docs.bindprotocol.com)
+- [DIMO Network](https://dimo.zone)

package/dist/adapters/dimo/index.cjs

@@ -0,0 +1,108 @@
+'use strict';
+
+// src/adapters/dimo/queries.ts
+function buildTelemetryQuery(vehicleTokenId, from, to) {
+  return `{
+  signals(
+    tokenId: ${vehicleTokenId},
+    interval: "1h",
+    from: ${from},
+    to: ${to}
+  ) {
+    powertrainTransmissionTravelledDistance(agg: AVG)
+    speed(agg: AVG)
+    powertrainCombustionEngineSpeed(agg: AVG)
+    obdEngineLoad(agg: AVG)
+    obdDTCList(agg: UNIQUE)
+    obdRunTime(agg: AVG)
+    timestamp
+  }
+}`;
+}
+function buildCustomTelemetryQuery(vehicleTokenId, from, to, signals, interval = "1h") {
+  const signalLines = signals.map((s) => {
+    if (s.aggregation) {
+      return `    ${s.name}(agg: ${s.aggregation})`;
+    }
+    return `    ${s.name}`;
+  }).join("\n");
+  return `{
+  signals(
+    tokenId: ${vehicleTokenId},
+    interval: "${interval}",
+    from: ${from},
+    to: ${to}
+  ) {
+${signalLines}
+    timestamp
+  }
+}`;
+}
+
+// src/adapters/dimo/adapter.ts
+var SUPPORTED_CIRCUITS = [
+  "bind.mobility.riskband.v1"
+];
+var DimoAdapter = class {
+  id = "dimo";
+  name = "DIMO Network";
+  description = "Fetches vehicle telemetry data from the DIMO decentralized network";
+  dimoClient;
+  constructor(config) {
+    this.dimoClient = config.dimoClient;
+  }
+  /**
+   * Fetch telemetry data from DIMO for a vehicle
+   * @param query - Query parameters including vehicle token ID and date range
+   * @returns Raw telemetry data from DIMO
+   */
+  async fetchData(query) {
+    const graphqlQuery = buildTelemetryQuery(query.vehicleTokenId, query.from, query.to);
+    const result = await this.dimoClient.telemetry.query(graphqlQuery);
+    return result;
+  }
+  /**
+   * Transform DIMO telemetry data into circuit inputs
+   * @param data - Raw telemetry data from DIMO
+   * @param circuitId - Target circuit ID
+   * @returns Inputs ready for prove job submission
+   */
+  toCircuitInputs(data, circuitId) {
+    if (!SUPPORTED_CIRCUITS.includes(circuitId)) {
+      throw new Error(
+        `Circuit "${circuitId}" is not supported by the DIMO adapter. Supported circuits: ${SUPPORTED_CIRCUITS.join(", ")}`
+      );
+    }
+    switch (circuitId) {
+      case "bind.mobility.riskband.v1":
+        return this.toRiskBandInputs(data);
+      default:
+        throw new Error(`No input transformer for circuit: ${circuitId}`);
+    }
+  }
+  /**
+   * Get the list of circuits this adapter supports
+   */
+  getSupportedCircuits() {
+    return [...SUPPORTED_CIRCUITS];
+  }
+  // ===========================================================================
+  // Private transformers
+  // ===========================================================================
+  toRiskBandInputs(data) {
+    return {
+      signals: JSON.stringify(data.signals),
+      timestamp: data.timestamp
+    };
+  }
+};
+function createDimoAdapter(config) {
+  return new DimoAdapter(config);
+}
+
+exports.DimoAdapter = DimoAdapter;
+exports.buildCustomTelemetryQuery = buildCustomTelemetryQuery;
+exports.buildTelemetryQuery = buildTelemetryQuery;
+exports.createDimoAdapter = createDimoAdapter;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/adapters/dimo/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/adapters/dimo/queries.ts","../../../src/adapters/dimo/adapter.ts"],"names":[],"mappings":";;;AAWO,SAAS,mBAAA,CACd,cAAA,EACA,IAAA,EACA,EAAA,EACQ;AACR,EAAA,OAAO,CAAA;AAAA;AAAA,aAAA,EAEM,cAAc,CAAA;AAAA;AAAA,UAAA,EAEjB,IAAI,CAAA;AAAA,QAAA,EACN,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,CAAA,CAAA;AAWZ;AAMO,SAAS,0BACd,cAAA,EACA,IAAA,EACA,EAAA,EACA,OAAA,EAIA,WAAW,IAAA,EACH;AACR,EAAA,MAAM,WAAA,GAAc,OAAA,CACjB,GAAA,CAAI,CAAC,CAAA,KAAM;AACV,IAAA,IAAI,EAAE,WAAA,EAAa;AACjB,MAAA,OAAO,CAAA,IAAA,EAAO,CAAA,CAAE,IAAI,CAAA,MAAA,EAAS,EAAE,WAAW,CAAA,CAAA,CAAA;AAAA,IAC5C;AACA,IAAA,OAAO,CAAA,IAAA,EAAO,EAAE,IAAI,CAAA,CAAA;AAAA,EACtB,CAAC,CAAA,CACA,IAAA,CAAK,IAAI,CAAA;AAEZ,EAAA,OAAO,CAAA;AAAA;AAAA,aAAA,EAEM,cAAc,CAAA;AAAA,eAAA,EACZ,QAAQ,CAAA;AAAA,UAAA,EACb,IAAI,CAAA;AAAA,QAAA,EACN,EAAE;AAAA;AAAA,EAEV,WAAW;AAAA;AAAA;AAAA,CAAA,CAAA;AAIb;;;ACxDA,IAAM,kBAAA,GAAqB;AAAA,EACzB;AACF,CAAA;AAEO,IAAM,cAAN,MAA0F;AAAA,EACtF,EAAA,GAAK,MAAA;AAAA,EACL,IAAA,GAAO,cAAA;AAAA,EACP,WAAA,GAAc,oEAAA;AAAA,EAEN,UAAA;AAAA,EAEjB,YAAY,MAAA,EAA2B;AACrC,IAAA,IAAA,CAAK,aAAa,MAAA,CAAO,UAAA;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,UAAU,KAAA,EAA8C;AAC5D,IAAA,MAAM,eAAe,mBAAA,CAAoB,KAAA,CAAM,gBAAgB,KAAA,CAAM,IAAA,EAAM,MAAM,EAAE,CAAA;AACnF,IAAA,MAAM,SAAS,MAAM,IAAA,CAAK,UAAA,CAAW,SAAA,CAAU,MAAM,YAAY,CAAA;AACjE,IAAA,OAAO,MAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,eAAA,CAAgB,MAAyB,SAAA,EAAmC;AAC1E,IAAA,IAAI,CAAC,kBAAA,CAAmB,QAAA,CAAS,SAAS,CAAA,EAAG;AAC3C,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,YAAY,SAAS,CAAA,4DAAA,EACE,kBAAA,CAAmB,IAAA,CAAK,IAAI,CAAC,CAAA;AAAA,OACtD;AAAA,IACF;AAGA,IAAA,QAAQ,SAAA;AAAW,MACjB,KAAK,2BAAA;AACH,QAAA,OAAO,IAAA,CAAK,iBAAiB,IAAI,CAAA;AAAA,MACnC;AACE,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,kCAAA,EAAqC,SAAS,CAAA,CAAE,CAAA;AAAA;AACpE,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,oBAAA,GAAiC;AAC/B,IAAA,OAAO,CAAC,GAAG,kBAAkB,CAAA;AAAA,EAC/B;AAAA;AAAA;AAAA;AAAA,EAMQ,iBAAiB,IAAA,EAAyC;AAChE,IAAA,OAAO;AAAA,MACL,OAAA,EAAS,IAAA,CAAK,SAAA,CAAU,IAAA,CAAK,OAAO,CAAA;AAAA,MACpC,WAAW,IAAA,CAAK;AAAA,KAClB;AAAA,EACF;AACF;AAKO,SAAS,kBAAkB,MAAA,EAAwC;AACxE,EAAA,OAAO,IAAI,YAAY,MAAM,CAAA;AAC/B","file":"index.cjs","sourcesContent":["/**\n * DIMO GraphQL query builders\n */\n\n/**\n * Build a GraphQL query for fetching vehicle telemetry\n * @param vehicleTokenId - The DIMO vehicle token ID\n * @param from - Start date (ISO 8601 or date string)\n * @param to - End date (ISO 8601 or date string)\n * @returns GraphQL query string\n */\nexport function buildTelemetryQuery(\n  vehicleTokenId: string,\n  from: string,\n  to: string\n): string {\n  return `{\n  signals(\n    tokenId: ${vehicleTokenId},\n    interval: \"1h\",\n    from: ${from},\n    to: ${to}\n  ) {\n    powertrainTransmissionTravelledDistance(agg: AVG)\n    speed(agg: AVG)\n    powertrainCombustionEngineSpeed(agg: AVG)\n    obdEngineLoad(agg: AVG)\n    obdDTCList(agg: UNIQUE)\n    obdRunTime(agg: AVG)\n    timestamp\n  }\n}`;\n}\n\n/**\n * Build a GraphQL query for fetching specific signals\n * Allows customization of which signals to fetch and their aggregation\n */\nexport function buildCustomTelemetryQuery(\n  vehicleTokenId: string,\n  from: string,\n  to: string,\n  signals: Array<{\n    name: string;\n    aggregation?: 'AVG' | 'SUM' | 'MIN' | 'MAX' | 'UNIQUE' | 'COUNT';\n  }>,\n  interval = '1h'\n): string {\n  const signalLines = signals\n    .map((s) => {\n      if (s.aggregation) {\n        return `    ${s.name}(agg: ${s.aggregation})`;\n      }\n      return `    ${s.name}`;\n    })\n    .join('\\n');\n\n  return `{\n  signals(\n    tokenId: ${vehicleTokenId},\n    interval: \"${interval}\",\n    from: ${from},\n    to: ${to}\n  ) {\n${signalLines}\n    timestamp\n  }\n}`;\n}\n","/**\n * DIMO Adapter\n *\n * Fetches vehicle telemetry data from the DIMO network and transforms it\n * into circuit inputs for Bind Protocol prove jobs.\n */\n\nimport type { DataAdapter } from '../types';\nimport type { ProveJobInputs } from '../../core/types';\nimport type { DimoAdapterConfig, DimoQuery, DimoTelemetryData, DimoClient } from './types';\nimport { buildTelemetryQuery } from './queries';\n\nconst SUPPORTED_CIRCUITS = [\n  'bind.mobility.riskband.v1',\n];\n\nexport class DimoAdapter implements DataAdapter<DimoAdapterConfig, DimoQuery, DimoTelemetryData> {\n  readonly id = 'dimo';\n  readonly name = 'DIMO Network';\n  readonly description = 'Fetches vehicle telemetry data from the DIMO decentralized network';\n\n  private readonly dimoClient: DimoClient;\n\n  constructor(config: DimoAdapterConfig) {\n    this.dimoClient = config.dimoClient;\n  }\n\n  /**\n   * Fetch telemetry data from DIMO for a vehicle\n   * @param query - Query parameters including vehicle token ID and date range\n   * @returns Raw telemetry data from DIMO\n   */\n  async fetchData(query: DimoQuery): Promise<DimoTelemetryData> {\n    const graphqlQuery = buildTelemetryQuery(query.vehicleTokenId, query.from, query.to);\n    const result = await this.dimoClient.telemetry.query(graphqlQuery);\n    return result;\n  }\n\n  /**\n   * Transform DIMO telemetry data into circuit inputs\n   * @param data - Raw telemetry data from DIMO\n   * @param circuitId - Target circuit ID\n   * @returns Inputs ready for prove job submission\n   */\n  toCircuitInputs(data: DimoTelemetryData, circuitId: string): ProveJobInputs {\n    if (!SUPPORTED_CIRCUITS.includes(circuitId)) {\n      throw new Error(\n        `Circuit \"${circuitId}\" is not supported by the DIMO adapter. ` +\n        `Supported circuits: ${SUPPORTED_CIRCUITS.join(', ')}`\n      );\n    }\n\n    // Transform based on circuit type\n    switch (circuitId) {\n      case 'bind.mobility.riskband.v1':\n        return this.toRiskBandInputs(data);\n      default:\n        throw new Error(`No input transformer for circuit: ${circuitId}`);\n    }\n  }\n\n  /**\n   * Get the list of circuits this adapter supports\n   */\n  getSupportedCircuits(): string[] {\n    return [...SUPPORTED_CIRCUITS];\n  }\n\n  // ===========================================================================\n  // Private transformers\n  // ===========================================================================\n\n  private toRiskBandInputs(data: DimoTelemetryData): ProveJobInputs {\n    return {\n      signals: JSON.stringify(data.signals),\n      timestamp: data.timestamp,\n    };\n  }\n}\n\n/**\n * Factory function to create a DIMO adapter\n */\nexport function createDimoAdapter(config: DimoAdapterConfig): DimoAdapter {\n  return new DimoAdapter(config);\n}\n"]}

package/dist/adapters/dimo/index.d.cts

@@ -0,0 +1,24 @@
+export { D as DimoAdapter, a as DimoAdapterConfig, f as DimoClient, b as DimoQuery, e as DimoSignal, d as DimoTelemetryData, c as createDimoAdapter } from '../../index-5j-fuebC.cjs';
+import '../../types-o4sbOK_a.cjs';
+
+/**
+ * DIMO GraphQL query builders
+ */
+/**
+ * Build a GraphQL query for fetching vehicle telemetry
+ * @param vehicleTokenId - The DIMO vehicle token ID
+ * @param from - Start date (ISO 8601 or date string)
+ * @param to - End date (ISO 8601 or date string)
+ * @returns GraphQL query string
+ */
+declare function buildTelemetryQuery(vehicleTokenId: string, from: string, to: string): string;
+/**
+ * Build a GraphQL query for fetching specific signals
+ * Allows customization of which signals to fetch and their aggregation
+ */
+declare function buildCustomTelemetryQuery(vehicleTokenId: string, from: string, to: string, signals: Array<{
+    name: string;
+    aggregation?: 'AVG' | 'SUM' | 'MIN' | 'MAX' | 'UNIQUE' | 'COUNT';
+}>, interval?: string): string;
+
+export { buildCustomTelemetryQuery, buildTelemetryQuery };

package/dist/adapters/dimo/index.d.ts

@@ -0,0 +1,24 @@
+export { D as DimoAdapter, a as DimoAdapterConfig, f as DimoClient, b as DimoQuery, e as DimoSignal, d as DimoTelemetryData, c as createDimoAdapter } from '../../index-CASjN9Qe.js';
+import '../../types-o4sbOK_a.js';
+
+/**
+ * DIMO GraphQL query builders
+ */
+/**
+ * Build a GraphQL query for fetching vehicle telemetry
+ * @param vehicleTokenId - The DIMO vehicle token ID
+ * @param from - Start date (ISO 8601 or date string)
+ * @param to - End date (ISO 8601 or date string)
+ * @returns GraphQL query string
+ */
+declare function buildTelemetryQuery(vehicleTokenId: string, from: string, to: string): string;
+/**
+ * Build a GraphQL query for fetching specific signals
+ * Allows customization of which signals to fetch and their aggregation
+ */
+declare function buildCustomTelemetryQuery(vehicleTokenId: string, from: string, to: string, signals: Array<{
+    name: string;
+    aggregation?: 'AVG' | 'SUM' | 'MIN' | 'MAX' | 'UNIQUE' | 'COUNT';
+}>, interval?: string): string;
+
+export { buildCustomTelemetryQuery, buildTelemetryQuery };

package/dist/adapters/dimo/index.js

@@ -0,0 +1,103 @@
+// src/adapters/dimo/queries.ts
+function buildTelemetryQuery(vehicleTokenId, from, to) {
+  return `{
+  signals(
+    tokenId: ${vehicleTokenId},
+    interval: "1h",
+    from: ${from},
+    to: ${to}
+  ) {
+    powertrainTransmissionTravelledDistance(agg: AVG)
+    speed(agg: AVG)
+    powertrainCombustionEngineSpeed(agg: AVG)
+    obdEngineLoad(agg: AVG)
+    obdDTCList(agg: UNIQUE)
+    obdRunTime(agg: AVG)
+    timestamp
+  }
+}`;
+}
+function buildCustomTelemetryQuery(vehicleTokenId, from, to, signals, interval = "1h") {
+  const signalLines = signals.map((s) => {
+    if (s.aggregation) {
+      return `    ${s.name}(agg: ${s.aggregation})`;
+    }
+    return `    ${s.name}`;
+  }).join("\n");
+  return `{
+  signals(
+    tokenId: ${vehicleTokenId},
+    interval: "${interval}",
+    from: ${from},
+    to: ${to}
+  ) {
+${signalLines}
+    timestamp
+  }
+}`;
+}
+
+// src/adapters/dimo/adapter.ts
+var SUPPORTED_CIRCUITS = [
+  "bind.mobility.riskband.v1"
+];
+var DimoAdapter = class {
+  id = "dimo";
+  name = "DIMO Network";
+  description = "Fetches vehicle telemetry data from the DIMO decentralized network";
+  dimoClient;
+  constructor(config) {
+    this.dimoClient = config.dimoClient;
+  }
+  /**
+   * Fetch telemetry data from DIMO for a vehicle
+   * @param query - Query parameters including vehicle token ID and date range
+   * @returns Raw telemetry data from DIMO
+   */
+  async fetchData(query) {
+    const graphqlQuery = buildTelemetryQuery(query.vehicleTokenId, query.from, query.to);
+    const result = await this.dimoClient.telemetry.query(graphqlQuery);
+    return result;
+  }
+  /**
+   * Transform DIMO telemetry data into circuit inputs
+   * @param data - Raw telemetry data from DIMO
+   * @param circuitId - Target circuit ID
+   * @returns Inputs ready for prove job submission
+   */
+  toCircuitInputs(data, circuitId) {
+    if (!SUPPORTED_CIRCUITS.includes(circuitId)) {
+      throw new Error(
+        `Circuit "${circuitId}" is not supported by the DIMO adapter. Supported circuits: ${SUPPORTED_CIRCUITS.join(", ")}`
+      );
+    }
+    switch (circuitId) {
+      case "bind.mobility.riskband.v1":
+        return this.toRiskBandInputs(data);
+      default:
+        throw new Error(`No input transformer for circuit: ${circuitId}`);
+    }
+  }
+  /**
+   * Get the list of circuits this adapter supports
+   */
+  getSupportedCircuits() {
+    return [...SUPPORTED_CIRCUITS];
+  }
+  // ===========================================================================
+  // Private transformers
+  // ===========================================================================
+  toRiskBandInputs(data) {
+    return {
+      signals: JSON.stringify(data.signals),
+      timestamp: data.timestamp
+    };
+  }
+};
+function createDimoAdapter(config) {
+  return new DimoAdapter(config);
+}
+
+export { DimoAdapter, buildCustomTelemetryQuery, buildTelemetryQuery, createDimoAdapter };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/adapters/dimo/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/adapters/dimo/queries.ts","../../../src/adapters/dimo/adapter.ts"],"names":[],"mappings":";AAWO,SAAS,mBAAA,CACd,cAAA,EACA,IAAA,EACA,EAAA,EACQ;AACR,EAAA,OAAO,CAAA;AAAA;AAAA,aAAA,EAEM,cAAc,CAAA;AAAA;AAAA,UAAA,EAEjB,IAAI,CAAA;AAAA,QAAA,EACN,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,CAAA,CAAA;AAWZ;AAMO,SAAS,0BACd,cAAA,EACA,IAAA,EACA,EAAA,EACA,OAAA,EAIA,WAAW,IAAA,EACH;AACR,EAAA,MAAM,WAAA,GAAc,OAAA,CACjB,GAAA,CAAI,CAAC,CAAA,KAAM;AACV,IAAA,IAAI,EAAE,WAAA,EAAa;AACjB,MAAA,OAAO,CAAA,IAAA,EAAO,CAAA,CAAE,IAAI,CAAA,MAAA,EAAS,EAAE,WAAW,CAAA,CAAA,CAAA;AAAA,IAC5C;AACA,IAAA,OAAO,CAAA,IAAA,EAAO,EAAE,IAAI,CAAA,CAAA;AAAA,EACtB,CAAC,CAAA,CACA,IAAA,CAAK,IAAI,CAAA;AAEZ,EAAA,OAAO,CAAA;AAAA;AAAA,aAAA,EAEM,cAAc,CAAA;AAAA,eAAA,EACZ,QAAQ,CAAA;AAAA,UAAA,EACb,IAAI,CAAA;AAAA,QAAA,EACN,EAAE;AAAA;AAAA,EAEV,WAAW;AAAA;AAAA;AAAA,CAAA,CAAA;AAIb;;;ACxDA,IAAM,kBAAA,GAAqB;AAAA,EACzB;AACF,CAAA;AAEO,IAAM,cAAN,MAA0F;AAAA,EACtF,EAAA,GAAK,MAAA;AAAA,EACL,IAAA,GAAO,cAAA;AAAA,EACP,WAAA,GAAc,oEAAA;AAAA,EAEN,UAAA;AAAA,EAEjB,YAAY,MAAA,EAA2B;AACrC,IAAA,IAAA,CAAK,aAAa,MAAA,CAAO,UAAA;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,UAAU,KAAA,EAA8C;AAC5D,IAAA,MAAM,eAAe,mBAAA,CAAoB,KAAA,CAAM,gBAAgB,KAAA,CAAM,IAAA,EAAM,MAAM,EAAE,CAAA;AACnF,IAAA,MAAM,SAAS,MAAM,IAAA,CAAK,UAAA,CAAW,SAAA,CAAU,MAAM,YAAY,CAAA;AACjE,IAAA,OAAO,MAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,eAAA,CAAgB,MAAyB,SAAA,EAAmC;AAC1E,IAAA,IAAI,CAAC,kBAAA,CAAmB,QAAA,CAAS,SAAS,CAAA,EAAG;AAC3C,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,YAAY,SAAS,CAAA,4DAAA,EACE,kBAAA,CAAmB,IAAA,CAAK,IAAI,CAAC,CAAA;AAAA,OACtD;AAAA,IACF;AAGA,IAAA,QAAQ,SAAA;AAAW,MACjB,KAAK,2BAAA;AACH,QAAA,OAAO,IAAA,CAAK,iBAAiB,IAAI,CAAA;AAAA,MACnC;AACE,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,kCAAA,EAAqC,SAAS,CAAA,CAAE,CAAA;AAAA;AACpE,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,oBAAA,GAAiC;AAC/B,IAAA,OAAO,CAAC,GAAG,kBAAkB,CAAA;AAAA,EAC/B;AAAA;AAAA;AAAA;AAAA,EAMQ,iBAAiB,IAAA,EAAyC;AAChE,IAAA,OAAO;AAAA,MACL,OAAA,EAAS,IAAA,CAAK,SAAA,CAAU,IAAA,CAAK,OAAO,CAAA;AAAA,MACpC,WAAW,IAAA,CAAK;AAAA,KAClB;AAAA,EACF;AACF;AAKO,SAAS,kBAAkB,MAAA,EAAwC;AACxE,EAAA,OAAO,IAAI,YAAY,MAAM,CAAA;AAC/B","file":"index.js","sourcesContent":["/**\n * DIMO GraphQL query builders\n */\n\n/**\n * Build a GraphQL query for fetching vehicle telemetry\n * @param vehicleTokenId - The DIMO vehicle token ID\n * @param from - Start date (ISO 8601 or date string)\n * @param to - End date (ISO 8601 or date string)\n * @returns GraphQL query string\n */\nexport function buildTelemetryQuery(\n  vehicleTokenId: string,\n  from: string,\n  to: string\n): string {\n  return `{\n  signals(\n    tokenId: ${vehicleTokenId},\n    interval: \"1h\",\n    from: ${from},\n    to: ${to}\n  ) {\n    powertrainTransmissionTravelledDistance(agg: AVG)\n    speed(agg: AVG)\n    powertrainCombustionEngineSpeed(agg: AVG)\n    obdEngineLoad(agg: AVG)\n    obdDTCList(agg: UNIQUE)\n    obdRunTime(agg: AVG)\n    timestamp\n  }\n}`;\n}\n\n/**\n * Build a GraphQL query for fetching specific signals\n * Allows customization of which signals to fetch and their aggregation\n */\nexport function buildCustomTelemetryQuery(\n  vehicleTokenId: string,\n  from: string,\n  to: string,\n  signals: Array<{\n    name: string;\n    aggregation?: 'AVG' | 'SUM' | 'MIN' | 'MAX' | 'UNIQUE' | 'COUNT';\n  }>,\n  interval = '1h'\n): string {\n  const signalLines = signals\n    .map((s) => {\n      if (s.aggregation) {\n        return `    ${s.name}(agg: ${s.aggregation})`;\n      }\n      return `    ${s.name}`;\n    })\n    .join('\\n');\n\n  return `{\n  signals(\n    tokenId: ${vehicleTokenId},\n    interval: \"${interval}\",\n    from: ${from},\n    to: ${to}\n  ) {\n${signalLines}\n    timestamp\n  }\n}`;\n}\n","/**\n * DIMO Adapter\n *\n * Fetches vehicle telemetry data from the DIMO network and transforms it\n * into circuit inputs for Bind Protocol prove jobs.\n */\n\nimport type { DataAdapter } from '../types';\nimport type { ProveJobInputs } from '../../core/types';\nimport type { DimoAdapterConfig, DimoQuery, DimoTelemetryData, DimoClient } from './types';\nimport { buildTelemetryQuery } from './queries';\n\nconst SUPPORTED_CIRCUITS = [\n  'bind.mobility.riskband.v1',\n];\n\nexport class DimoAdapter implements DataAdapter<DimoAdapterConfig, DimoQuery, DimoTelemetryData> {\n  readonly id = 'dimo';\n  readonly name = 'DIMO Network';\n  readonly description = 'Fetches vehicle telemetry data from the DIMO decentralized network';\n\n  private readonly dimoClient: DimoClient;\n\n  constructor(config: DimoAdapterConfig) {\n    this.dimoClient = config.dimoClient;\n  }\n\n  /**\n   * Fetch telemetry data from DIMO for a vehicle\n   * @param query - Query parameters including vehicle token ID and date range\n   * @returns Raw telemetry data from DIMO\n   */\n  async fetchData(query: DimoQuery): Promise<DimoTelemetryData> {\n    const graphqlQuery = buildTelemetryQuery(query.vehicleTokenId, query.from, query.to);\n    const result = await this.dimoClient.telemetry.query(graphqlQuery);\n    return result;\n  }\n\n  /**\n   * Transform DIMO telemetry data into circuit inputs\n   * @param data - Raw telemetry data from DIMO\n   * @param circuitId - Target circuit ID\n   * @returns Inputs ready for prove job submission\n   */\n  toCircuitInputs(data: DimoTelemetryData, circuitId: string): ProveJobInputs {\n    if (!SUPPORTED_CIRCUITS.includes(circuitId)) {\n      throw new Error(\n        `Circuit \"${circuitId}\" is not supported by the DIMO adapter. ` +\n        `Supported circuits: ${SUPPORTED_CIRCUITS.join(', ')}`\n      );\n    }\n\n    // Transform based on circuit type\n    switch (circuitId) {\n      case 'bind.mobility.riskband.v1':\n        return this.toRiskBandInputs(data);\n      default:\n        throw new Error(`No input transformer for circuit: ${circuitId}`);\n    }\n  }\n\n  /**\n   * Get the list of circuits this adapter supports\n   */\n  getSupportedCircuits(): string[] {\n    return [...SUPPORTED_CIRCUITS];\n  }\n\n  // ===========================================================================\n  // Private transformers\n  // ===========================================================================\n\n  private toRiskBandInputs(data: DimoTelemetryData): ProveJobInputs {\n    return {\n      signals: JSON.stringify(data.signals),\n      timestamp: data.timestamp,\n    };\n  }\n}\n\n/**\n * Factory function to create a DIMO adapter\n */\nexport function createDimoAdapter(config: DimoAdapterConfig): DimoAdapter {\n  return new DimoAdapter(config);\n}\n"]}

package/dist/adapters/index.cjs

@@ -0,0 +1,83 @@
+'use strict';
+
+// src/adapters/dimo/queries.ts
+function buildTelemetryQuery(vehicleTokenId, from, to) {
+  return `{
+  signals(
+    tokenId: ${vehicleTokenId},
+    interval: "1h",
+    from: ${from},
+    to: ${to}
+  ) {
+    powertrainTransmissionTravelledDistance(agg: AVG)
+    speed(agg: AVG)
+    powertrainCombustionEngineSpeed(agg: AVG)
+    obdEngineLoad(agg: AVG)
+    obdDTCList(agg: UNIQUE)
+    obdRunTime(agg: AVG)
+    timestamp
+  }
+}`;
+}
+
+// src/adapters/dimo/adapter.ts
+var SUPPORTED_CIRCUITS = [
+  "bind.mobility.riskband.v1"
+];
+var DimoAdapter = class {
+  id = "dimo";
+  name = "DIMO Network";
+  description = "Fetches vehicle telemetry data from the DIMO decentralized network";
+  dimoClient;
+  constructor(config) {
+    this.dimoClient = config.dimoClient;
+  }
+  /**
+   * Fetch telemetry data from DIMO for a vehicle
+   * @param query - Query parameters including vehicle token ID and date range
+   * @returns Raw telemetry data from DIMO
+   */
+  async fetchData(query) {
+    const graphqlQuery = buildTelemetryQuery(query.vehicleTokenId, query.from, query.to);
+    const result = await this.dimoClient.telemetry.query(graphqlQuery);
+    return result;
+  }
+  /**
+   * Transform DIMO telemetry data into circuit inputs
+   * @param data - Raw telemetry data from DIMO
+   * @param circuitId - Target circuit ID
+   * @returns Inputs ready for prove job submission
+   */
+  toCircuitInputs(data, circuitId) {
+    if (!SUPPORTED_CIRCUITS.includes(circuitId)) {
+      throw new Error(
+        `Circuit "${circuitId}" is not supported by the DIMO adapter. Supported circuits: ${SUPPORTED_CIRCUITS.join(", ")}`
+      );
+    }
+    switch (circuitId) {
+      case "bind.mobility.riskband.v1":
+        return this.toRiskBandInputs(data);
+      default:
+        throw new Error(`No input transformer for circuit: ${circuitId}`);
+    }
+  }
+  /**
+   * Get the list of circuits this adapter supports
+   */
+  getSupportedCircuits() {
+    return [...SUPPORTED_CIRCUITS];
+  }
+  // ===========================================================================
+  // Private transformers
+  // ===========================================================================
+  toRiskBandInputs(data) {
+    return {
+      signals: JSON.stringify(data.signals),
+      timestamp: data.timestamp
+    };
+  }
+};
+
+exports.DimoAdapter = DimoAdapter;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map