@jinn-network/client 0.1.0-canary.adfd078d

package/dist/discovery/registry.d.ts

@@ -0,0 +1,43 @@
+/**
+ * ERC-8004 Identity Registry integration for artifact discovery.
+ *
+ * Registers artifacts and nodes on-chain so other operators can discover
+ * them via subgraph queries. Ported from protocol/src/discovery/registry.ts.
+ */
+export interface RegistryConfig {
+    /** CAIP-2 chain identifier, e.g. 'eip155:8453' */
+    chainId: string;
+    /** EVM address of the 8004 Identity Registry contract */
+    contractAddress: string;
+    /** Hex private key for signing transactions */
+    privateKey: string;
+    /** Optional RPC URL override */
+    rpcUrl?: string;
+}
+export declare class Registry8004 {
+    private readonly walletClient;
+    private readonly publicClient;
+    private readonly account;
+    private readonly chain;
+    private readonly contractAddress;
+    constructor(config: RegistryConfig);
+    private _register;
+    /**
+     * Register this node on the 8004 Identity Registry.
+     */
+    registerNode(nodeInfo: {
+        endpoint: string;
+        ownerAddress: string;
+        price?: string;
+    }): Promise<bigint>;
+    /**
+     * Register an artifact on the 8004 Identity Registry.
+     */
+    registerArtifact(artifact: {
+        id: string;
+        title: string;
+        tags: string[];
+        outcome: string;
+        endpoint: string;
+    }): Promise<bigint>;
+}

package/dist/discovery/registry.js

@@ -0,0 +1,104 @@
+/**
+ * ERC-8004 Identity Registry integration for artifact discovery.
+ *
+ * Registers artifacts and nodes on-chain so other operators can discover
+ * them via subgraph queries. Ported from protocol/src/discovery/registry.ts.
+ */
+import { createPublicClient, createWalletClient, http } from 'viem';
+import { privateKeyToAccount } from 'viem/accounts';
+const IDENTITY_REGISTRY_ABI = [
+    {
+        name: 'register',
+        type: 'function',
+        inputs: [
+            { name: 'agentURI', type: 'string' },
+            {
+                name: 'metadata',
+                type: 'tuple[]',
+                components: [
+                    { name: 'metadataKey', type: 'string' },
+                    { name: 'metadataValue', type: 'bytes' },
+                ],
+            },
+        ],
+        outputs: [{ name: 'agentId', type: 'uint256' }],
+        stateMutability: 'nonpayable',
+    },
+];
+const DEFAULT_RPC_URLS = {
+    'eip155:8453': 'https://mainnet.base.org',
+    'eip155:84532': 'https://sepolia.base.org',
+};
+function encodeMetadataValue(value) {
+    return ('0x' + Buffer.from(value).toString('hex'));
+}
+function getChainId(caip2) {
+    const parts = caip2.split(':');
+    if (parts.length !== 2 || parts[0] !== 'eip155') {
+        throw new Error(`Unsupported CAIP-2 format: ${caip2}`);
+    }
+    return parseInt(parts[1], 10);
+}
+export class Registry8004 {
+    walletClient;
+    publicClient;
+    account;
+    chain;
+    contractAddress;
+    constructor(config) {
+        const rpcUrl = config.rpcUrl ?? DEFAULT_RPC_URLS[config.chainId];
+        if (!rpcUrl)
+            throw new Error(`No RPC URL for chain ${config.chainId}`);
+        const chainId = getChainId(config.chainId);
+        this.chain = {
+            id: chainId,
+            name: `chain-${chainId}`,
+            nativeCurrency: { name: 'Ether', symbol: 'ETH', decimals: 18 },
+            rpcUrls: { default: { http: [rpcUrl] } },
+        };
+        const pk = (config.privateKey.startsWith('0x') ? config.privateKey : `0x${config.privateKey}`);
+        this.account = privateKeyToAccount(pk);
+        this.publicClient = createPublicClient({ chain: this.chain, transport: http(rpcUrl) });
+        this.walletClient = createWalletClient({ account: this.account, chain: this.chain, transport: http(rpcUrl) });
+        this.contractAddress = config.contractAddress;
+    }
+    async _register(uri, metadata) {
+        const hash = await this.walletClient.writeContract({
+            address: this.contractAddress,
+            abi: IDENTITY_REGISTRY_ABI,
+            functionName: 'register',
+            args: [uri, metadata],
+            account: this.account,
+            chain: this.chain,
+        });
+        const receipt = await this.publicClient.waitForTransactionReceipt({ hash });
+        return BigInt(receipt.blockNumber);
+    }
+    /**
+     * Register this node on the 8004 Identity Registry.
+     */
+    async registerNode(nodeInfo) {
+        const metadata = [
+            { metadataKey: 'documentType', metadataValue: encodeMetadataValue('adw:AgentCard') },
+            { metadataKey: 'endpoint', metadataValue: encodeMetadataValue(nodeInfo.endpoint) },
+            { metadataKey: 'ownerAddress', metadataValue: encodeMetadataValue(nodeInfo.ownerAddress) },
+            { metadataKey: 'price', metadataValue: encodeMetadataValue(nodeInfo.price ?? '$0') },
+        ];
+        return this._register(nodeInfo.endpoint, metadata);
+    }
+    /**
+     * Register an artifact on the 8004 Identity Registry.
+     */
+    async registerArtifact(artifact) {
+        const metadata = [
+            { metadataKey: 'documentType', metadataValue: encodeMetadataValue('adw:Artifact') },
+            { metadataKey: 'artifactId', metadataValue: encodeMetadataValue(artifact.id) },
+            { metadataKey: 'title', metadataValue: encodeMetadataValue(artifact.title) },
+            { metadataKey: 'outcome', metadataValue: encodeMetadataValue(artifact.outcome) },
+            { metadataKey: 'tags', metadataValue: encodeMetadataValue(JSON.stringify(artifact.tags)) },
+            { metadataKey: 'endpoint', metadataValue: encodeMetadataValue(artifact.endpoint) },
+        ];
+        return this._register(`artifact:${artifact.id}`, metadata);
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/discovery/registry.js.map

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

package/dist/discovery/subgraph.d.ts

@@ -0,0 +1,37 @@
+/**
+ * ERC-8004 Subgraph client for artifact and node discovery.
+ *
+ * Queries The Graph subgraph to discover artifacts and nodes registered
+ * on the 8004 Identity Registry. Ported from protocol/src/discovery/subgraph.ts.
+ *
+ * NOTE: The GraphQL schema depends on the deployed 8004 subgraph.
+ * Field names may need adjustment against the live subgraph.
+ */
+export interface SubgraphConfig {
+    url: string;
+}
+export interface SubgraphResult {
+    id: string;
+    agentURI: string;
+    owner: string;
+    metadata: Array<{
+        key: string;
+        value: string;
+    }>;
+}
+/**
+ * Parse a metadata value from a subgraph result by key.
+ */
+export declare function getMetadataValue(result: SubgraphResult, key: string): string | undefined;
+/**
+ * Query the 8004 subgraph for registered artifact entities.
+ */
+export declare function queryArtifacts(config: SubgraphConfig, filters?: {
+    outcome?: string;
+    owner?: string;
+    limit?: number;
+}): Promise<SubgraphResult[]>;
+/**
+ * Query the 8004 subgraph for registered node (AgentCard) entities.
+ */
+export declare function queryNodes(config: SubgraphConfig, limit?: number): Promise<SubgraphResult[]>;

package/dist/discovery/subgraph.js

@@ -0,0 +1,87 @@
+/**
+ * ERC-8004 Subgraph client for artifact and node discovery.
+ *
+ * Queries The Graph subgraph to discover artifacts and nodes registered
+ * on the 8004 Identity Registry. Ported from protocol/src/discovery/subgraph.ts.
+ *
+ * NOTE: The GraphQL schema depends on the deployed 8004 subgraph.
+ * Field names may need adjustment against the live subgraph.
+ */
+/**
+ * Parse a metadata value from a subgraph result by key.
+ */
+export function getMetadataValue(result, key) {
+    return result.metadata.find(m => m.key === key)?.value;
+}
+/**
+ * Query the 8004 subgraph for registered artifact entities.
+ */
+export async function queryArtifacts(config, filters) {
+    const query = filters?.owner
+        ? `query GetArtifacts($first: Int, $skip: Int, $owner: String) {
+        agents(
+          first: $first, skip: $skip,
+          where: { metadata_: { metadataKey: "documentType", metadataValue_contains: "Artifact" }, owner: $owner }
+        ) {
+          id agentURI owner
+          metadata { key: metadataKey value: metadataValue }
+        }
+      }`
+        : `query GetArtifacts($first: Int, $skip: Int) {
+        agents(
+          first: $first, skip: $skip,
+          where: { metadata_: { metadataKey: "documentType", metadataValue_contains: "Artifact" } }
+        ) {
+          id agentURI owner
+          metadata { key: metadataKey value: metadataValue }
+        }
+      }`;
+    const variables = {
+        first: filters?.limit ?? 100,
+        skip: 0,
+    };
+    if (filters?.owner)
+        variables['owner'] = filters.owner;
+    const data = await graphqlRequest(config.url, query, variables);
+    let results = data.agents;
+    if (filters?.outcome) {
+        results = results.filter(r => r.metadata.some(m => m.key === 'outcome' && m.value === filters.outcome));
+    }
+    return results;
+}
+/**
+ * Query the 8004 subgraph for registered node (AgentCard) entities.
+ */
+export async function queryNodes(config, limit) {
+    const query = `query GetNodes($first: Int, $skip: Int) {
+    agents(
+      first: $first, skip: $skip,
+      where: { metadata_: { metadataKey: "documentType", metadataValue_contains: "AgentCard" } }
+    ) {
+      id agentURI owner
+      metadata { key: metadataKey value: metadataValue }
+    }
+  }`;
+    const data = await graphqlRequest(config.url, query, { first: limit ?? 100, skip: 0 });
+    return data.agents;
+}
+// ── Minimal GraphQL client (no dependency) ───────────────────────────────────
+async function graphqlRequest(url, query, variables) {
+    const response = await fetch(url, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ query, variables }),
+    });
+    if (!response.ok) {
+        throw new Error(`Subgraph query failed: ${response.status} ${response.statusText}`);
+    }
+    const json = await response.json();
+    if (json.errors?.length) {
+        throw new Error(`Subgraph errors: ${json.errors.map(e => e.message).join(', ')}`);
+    }
+    if (!json.data) {
+        throw new Error('Subgraph returned no data');
+    }
+    return json.data;
+}
+//# sourceMappingURL=subgraph.js.map

package/dist/discovery/subgraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subgraph.js","sourceRoot":"","sources":["../../src/discovery/subgraph.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAsB,EAAE,GAAW;IAClE,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,EAAE,KAAK,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAsB,EACtB,OAIC;IAED,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK;QAC1B,CAAC,CAAC;;;;;;;;QAQE;QACJ,CAAC,CAAC;;;;;;;;QAQE,CAAC;IAEP,MAAM,SAAS,GAA4B;QACzC,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG;QAC5B,IAAI,EAAE,CAAC;KACR,CAAC;IACF,IAAI,OAAO,EAAE,KAAK;QAAE,SAAS,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;IAEvD,MAAM,IAAI,GAAG,MAAM,cAAc,CAA+B,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IAC9F,IAAI,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC;IAE1B,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC;QACrB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAC3B,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,CACzE,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAsB,EACtB,KAAc;IAEd,MAAM,KAAK,GAAG;;;;;;;;IAQZ,CAAC;IAEH,MAAM,IAAI,GAAG,MAAM,cAAc,CAA+B,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,IAAI,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;IACrH,OAAO,IAAI,CAAC,MAAM,CAAC;AACrB,CAAC;AAED,gFAAgF;AAEhF,KAAK,UAAU,cAAc,CAAI,GAAW,EAAE,KAAa,EAAE,SAAmC;IAC9F,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAChC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;KAC3C,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAuD,CAAC;IACxF,IAAI,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpF,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC;AACnB,CAAC"}

package/dist/earning/bootstrap.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Fleet bootstrap state machine.
+ *
+ * Phase 1 (master): generate mnemonic → fund master EOA
+ * Phase 2 (per-service): derive agent → stake → deploy mech
+ */
+import type { FleetState, FleetBootstrapResult } from './types.js';
+export interface FleetBootstrapperOptions {
+    earningDir?: string;
+    chain?: 'base' | 'base-sepolia';
+    rpcUrl?: string;
+    stakingMode?: 'standard' | 'self-bond';
+    targetServices?: number;
+    testnetL2DeploymentPath?: string;
+    testnetL2TokenDeploymentPath?: string;
+    testnetMechDeploymentPath?: string;
+    testnetStolasDeploymentPath?: string;
+    /** Verbose errors (default: JINN_DEBUG env or false). */
+    debug?: boolean;
+    /** Estimated master gas per day (wei) for runway warnings. */
+    masterEthDailyEstimateWei?: bigint | string;
+    /**
+     * When `masterEthDailyEstimateWei` is unset, blends a conservative daily estimate
+     * from poll frequency (config.pollIntervalMs).
+     */
+    pollIntervalMs?: number;
+}
+export declare class FleetBootstrapper {
+    private readonly store;
+    private readonly config;
+    private readonly publicClient;
+    private readonly chain;
+    private readonly stakingMode;
+    private readonly targetServices;
+    private readonly debug;
+    private readonly masterEthDailyEstimateWei;
+    constructor(options?: FleetBootstrapperOptions);
+    getStatus(): Promise<FleetState>;
+    /**
+     * Conservative daily master gas (wei): max(DEFAULT, rough tx count from poll interval × cost).
+     */
+    private estimateMasterDailyGasWei;
+    bootstrap(password: string): Promise<FleetBootstrapResult>;
+    /**
+     * If the master is only slightly above the minimum, warn about gas runway (heuristic days).
+     */
+    private warnMasterEthRunway;
+    private ensureMasterWallet;
+    private bootstrapService;
+    /**
+     * Compare persisted per-service state to registry/staking/Safe bytecode and patch store
+     * when local JSON is ahead, behind, or stale (idempotent; safe to repeat).
+     */
+    private reconcileFleetWithChain;
+    /** Best-effort ETH recovery before persisted Safe address is cleared or replaced. */
+    private sweepAbandonedSafeForService;
+    private gatherChainSignals;
+    private resumeService;
+    private resumeServiceStandard;
+    private resumeServiceSelfBond;
+    private stepStolasStake;
+    private recoverEvictedService;
+    private stepDeployMech;
+    private stepSelfBondSetup;
+    private stepSelfBondCreateService;
+    private stepSelfBondActivateService;
+    private stepSelfBondRegisterAgents;
+    private stepSelfBondDeployService;
+    private stepSelfBondStakeService;
+    private getOlasBalance;
+    private getServiceState;
+    private waitForSuccessfulTx;
+    private stolasPreflightCheck;
+    private getStakingState;
+    private parseServiceIdFromReceipt;
+    private parseMultisigFromReceipt;
+}
+/** @deprecated Use FleetBootstrapper */
+export declare const EarningBootstrapper: typeof FleetBootstrapper;