envoy-pay 0.1.0

package/dist/cjs/identity/agent-card.js

@@ -0,0 +1,143 @@
+"use strict";
+/**
+ * AgentCard — Capability and metadata registry for AI agents.
+ *
+ * Implements the ERC-8004 Identity Registry concept: each agent has
+ * a structured card describing its capabilities, service endpoints,
+ * owner, and multi-chain addresses.
+ *
+ * AgentCards are portable — they can be serialized to JSON and stored
+ * on IPFS, or registered on-chain as NFT metadata (ERC-721).
+ *
+ * @see ERC-8004 — Identity Registry (NFT-based agent IDs)
+ * @see Google A2A Protocol — AgentCard discovery
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentCard = void 0;
+class AgentCard {
+    data;
+    createdAt;
+    updatedAt;
+    constructor(data) {
+        this.validateCard(data);
+        this.data = { ...data };
+        this.createdAt = new Date();
+        this.updatedAt = new Date();
+    }
+    // ═══ Getters ══════════════════════════════════════════════════════
+    get name() { return this.data.name; }
+    get version() { return this.data.version; }
+    get description() { return this.data.description; }
+    get capabilities() { return [...this.data.capabilities]; }
+    get owner() { return this.data.owner; }
+    get endpoints() { return this.data.endpoints ? { ...this.data.endpoints } : undefined; }
+    get addresses() { return this.data.addresses ? [...this.data.addresses] : undefined; }
+    get tags() { return this.data.tags ? [...this.data.tags] : []; }
+    get iconUrl() { return this.data.iconUrl; }
+    // ═══ Capability Checks ════════════════════════════════════════════
+    /**
+     * Check if this agent has a specific capability.
+     */
+    hasCapability(capability) {
+        return this.data.capabilities.includes(capability.toLowerCase());
+    }
+    /**
+     * Check if this agent has ALL of the specified capabilities.
+     */
+    hasAllCapabilities(capabilities) {
+        return capabilities.every((c) => this.hasCapability(c));
+    }
+    /**
+     * Check if this agent has ANY of the specified capabilities.
+     */
+    hasAnyCapability(capabilities) {
+        return capabilities.some((c) => this.hasCapability(c));
+    }
+    // ═══ Updates ══════════════════════════════════════════════════════
+    /**
+     * Add a capability to the agent card.
+     */
+    addCapability(capability) {
+        const lower = capability.toLowerCase();
+        if (!this.data.capabilities.includes(lower)) {
+            this.data.capabilities.push(lower);
+            this.updatedAt = new Date();
+        }
+    }
+    /**
+     * Remove a capability from the agent card.
+     */
+    removeCapability(capability) {
+        const lower = capability.toLowerCase();
+        const index = this.data.capabilities.indexOf(lower);
+        if (index === -1)
+            return false;
+        this.data.capabilities.splice(index, 1);
+        this.updatedAt = new Date();
+        return true;
+    }
+    /**
+     * Update a service endpoint.
+     */
+    setEndpoint(type, url) {
+        if (!this.data.endpoints) {
+            this.data.endpoints = {};
+        }
+        this.data.endpoints[type] = url;
+        this.updatedAt = new Date();
+    }
+    /**
+     * Add a chain address to the agent card.
+     */
+    addAddress(chain, caip2Id, address) {
+        if (!this.data.addresses) {
+            this.data.addresses = [];
+        }
+        // Don't add duplicates
+        const exists = this.data.addresses.some((a) => a.caip2Id === caip2Id && a.address === address);
+        if (!exists) {
+            this.data.addresses.push({ chain, caip2Id, address });
+            this.updatedAt = new Date();
+        }
+    }
+    // ═══ Serialization ════════════════════════════════════════════════
+    /**
+     * Serialize to JSON (for IPFS, on-chain storage, etc.)
+     */
+    toJSON() {
+        return {
+            ...this.data,
+            createdAt: this.createdAt.toISOString(),
+            updatedAt: this.updatedAt.toISOString(),
+        };
+    }
+    /**
+     * Create an AgentCard from JSON.
+     */
+    static fromJSON(json) {
+        return new AgentCard(json);
+    }
+    /**
+     * Get the raw data.
+     */
+    getData() {
+        return { ...this.data };
+    }
+    // ═══ Validation ═══════════════════════════════════════════════════
+    validateCard(data) {
+        if (!data.name || data.name.trim().length === 0) {
+            throw new Error('Agent name is required');
+        }
+        if (!data.version || !/^\d+\.\d+\.\d+/.test(data.version)) {
+            throw new Error('Agent version must be semver (e.g., "1.0.0")');
+        }
+        if (!data.capabilities || data.capabilities.length === 0) {
+            throw new Error('Agent must have at least one capability');
+        }
+        if (!data.owner || data.owner.trim().length === 0) {
+            throw new Error('Agent owner address is required');
+        }
+    }
+}
+exports.AgentCard = AgentCard;
+//# sourceMappingURL=agent-card.js.map

package/dist/cjs/identity/agent-card.js.map

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

package/dist/cjs/identity/agent-identity.js

@@ -0,0 +1,166 @@
+"use strict";
+/**
+ * AgentIdentity — Main facade for the identity layer.
+ *
+ * Orchestrates DIDResolver, AgentCard, Reputation, and OwnerRegistry
+ * into a single, cohesive interface. This is the primary object that
+ * agents and the EnvoyClient interact with.
+ *
+ * @example
+ * ```ts
+ * const identity = new AgentIdentity({
+ *   metadata: {
+ *     name: 'Trading Bot Alpha',
+ *     version: '1.0.0',
+ *     capabilities: ['trade', 'analyze'],
+ *     owner: '0xOwner...',
+ *   },
+ *   signerAddress: '0xAgent...',
+ *   signerChainId: 'eip155:8453',
+ * });
+ *
+ * // Other agents can verify:
+ * const score = identity.getReputationScore();
+ * const canTrust = identity.meetsThreshold(70);
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentIdentity = void 0;
+const did_resolver_1 = require("./did-resolver");
+const agent_card_1 = require("./agent-card");
+const reputation_1 = require("./reputation");
+const owner_registry_1 = require("./owner-registry");
+class AgentIdentity {
+    /** The agent's DID. */
+    did;
+    /** The agent's DID Document. */
+    didDocument;
+    /** The agent's card (capabilities, metadata). */
+    card;
+    /** Shared modules (can be used across multiple agents). */
+    didResolver;
+    reputation;
+    ownerRegistry;
+    log;
+    constructor(options) {
+        this.log = options.logger ?? (() => { });
+        // Initialize modules
+        this.didResolver = new did_resolver_1.DIDResolver();
+        this.reputation = new reputation_1.Reputation();
+        this.ownerRegistry = new owner_registry_1.OwnerRegistry();
+        // Create agent card
+        this.card = new agent_card_1.AgentCard(options.metadata);
+        // Register DID
+        const { did, document } = this.didResolver.create(options.signerAddress, options.signerChainId, options.metadata);
+        this.did = did;
+        this.didDocument = document;
+        // Register ownership
+        this.ownerRegistry.register(this.did, options.metadata.owner, 'supervised');
+        this.log(`[Identity] 🆔 Agent identity created: ${this.did}`);
+        this.log(`[Identity] 🏷️ Name: ${options.metadata.name} v${options.metadata.version}`);
+        this.log(`[Identity] 🎯 Capabilities: ${options.metadata.capabilities.join(', ')}`);
+    }
+    // ═══ Identity API ═════════════════════════════════════════════════
+    /**
+     * Get the agent's DID string.
+     */
+    getDID() {
+        return this.did;
+    }
+    /**
+     * Get the agent's card data.
+     */
+    getCard() {
+        return this.card.getData();
+    }
+    /**
+     * Check if this agent has a specific capability.
+     */
+    hasCapability(capability) {
+        return this.card.hasCapability(capability);
+    }
+    // ═══ Reputation API ═══════════════════════════════════════════════
+    /**
+     * Get this agent's reputation score (0-100).
+     */
+    getReputationScore() {
+        return this.reputation.getScore(this.did);
+    }
+    /**
+     * Get this agent's full reputation profile.
+     */
+    getReputationProfile() {
+        return this.reputation.getProfile(this.did);
+    }
+    /**
+     * Check if this agent meets a minimum trust threshold.
+     */
+    meetsThreshold(minScore) {
+        return this.reputation.meetsThreshold(this.did, minScore);
+    }
+    /**
+     * Create a reputation attestation for ANOTHER agent.
+     */
+    attestAgent(options) {
+        this.log(`[Identity] ⭐ Attesting ${options.subject}: ${options.score}/100 (${options.category})`);
+        return this.reputation.attest(this.didDocument.controller, options);
+    }
+    // ═══ Ownership API ════════════════════════════════════════════════
+    /**
+     * Get this agent's owner.
+     */
+    getOwner() {
+        return this.ownerRegistry.getOwner(this.did);
+    }
+    /**
+     * Get this agent's delegation level.
+     */
+    getDelegationLevel() {
+        return this.ownerRegistry.getDelegationLevel(this.did);
+    }
+    /**
+     * Check if this agent can transact (not readonly).
+     */
+    canTransact() {
+        return this.ownerRegistry.canTransact(this.did);
+    }
+    // ═══ Resolution API (for discovering other agents) ════════════════
+    /**
+     * Resolve another agent's identity by DID.
+     */
+    resolveAgent(agentDid, options) {
+        const didDoc = this.didResolver.resolve(agentDid);
+        if (!didDoc)
+            return null;
+        const includeRep = options?.includeReputation ?? true;
+        const includeOwner = options?.includeOwnership ?? true;
+        // We don't have the card in this context — return a minimal version
+        const resolved = {
+            did: didDoc,
+            card: {
+                name: 'Unknown',
+                version: '0.0.0',
+                capabilities: [],
+                owner: didDoc.controller,
+            },
+            reputation: includeRep ? this.reputation.getProfile(agentDid) : undefined,
+            ownership: includeOwner ? this.ownerRegistry.getOwner(agentDid) ?? undefined : undefined,
+        };
+        return resolved;
+    }
+    // ═══ Serialization ════════════════════════════════════════════════
+    /**
+     * Export the full identity as a portable JSON object.
+     */
+    toJSON() {
+        return {
+            did: this.did,
+            didDocument: this.didDocument,
+            card: this.card.toJSON(),
+            reputation: this.reputation.getProfile(this.did),
+            ownership: this.ownerRegistry.getOwner(this.did),
+        };
+    }
+}
+exports.AgentIdentity = AgentIdentity;
+//# sourceMappingURL=agent-identity.js.map

package/dist/cjs/identity/agent-identity.js.map

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

package/dist/cjs/identity/did-resolver.js

@@ -0,0 +1,149 @@
+"use strict";
+/**
+ * DIDResolver — W3C Decentralized Identifier resolution for envoy agents.
+ *
+ * Implements a custom DID method `did:asg:agent:<chain>:<address>` that
+ * resolves to a DID Document containing the agent's public keys,
+ * service endpoints, and ownership information.
+ *
+ * Format: did:asg:agent:<caip2-chain>:<address>
+ * @example "did:asg:agent:eip155:8453:0x1234abcd..."
+ * @example "did:asg:agent:stellar:pubnet:GABC..."
+ * @example "did:asg:agent:solana:mainnet:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp..."
+ *
+ * @see https://www.w3.org/TR/did-core/
+ * @see ERC-8004 — Identity Registry
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DIDResolver = void 0;
+class DIDResolver {
+    /** In-memory registry (production: on-chain or IPFS). */
+    registry = new Map();
+    /**
+     * Create a DID for an agent.
+     *
+     * @param address - The agent's primary address
+     * @param chainId - CAIP-2 chain identifier
+     * @param card - Agent card metadata
+     * @returns The generated DID and DID Document
+     */
+    create(address, chainId, card) {
+        const did = this.buildDID(address, chainId);
+        const verificationMethod = {
+            id: `${did}#key-1`,
+            type: this.getKeyType(chainId),
+            controller: did,
+            publicKeyMultibase: this.addressToMultibase(address),
+        };
+        const services = [];
+        if (card.endpoints?.a2a) {
+            services.push({
+                id: `${did}#a2a`,
+                type: 'A2AEndpoint',
+                serviceEndpoint: card.endpoints.a2a,
+            });
+        }
+        if (card.endpoints?.mcp) {
+            services.push({
+                id: `${did}#mcp`,
+                type: 'MCPEndpoint',
+                serviceEndpoint: card.endpoints.mcp,
+            });
+        }
+        if (card.endpoints?.payment) {
+            services.push({
+                id: `${did}#payment`,
+                type: 'PaymentEndpoint',
+                serviceEndpoint: card.endpoints.payment,
+            });
+        }
+        const document = {
+            id: did,
+            controller: card.owner,
+            verificationMethod: [verificationMethod],
+            service: services,
+            created: new Date(),
+            updated: new Date(),
+        };
+        this.registry.set(did, document);
+        return { did, document };
+    }
+    /**
+     * Resolve a DID to its DID Document.
+     */
+    resolve(did) {
+        return this.registry.get(did) ?? null;
+    }
+    /**
+     * Parse a DID string into its components.
+     */
+    parse(did) {
+        const parts = did.split(':');
+        // did:asg:agent:<chainType>:<chainId>:<address>
+        // Minimum: did:asg:agent:chain:address = 5 parts
+        if (parts.length < 5 || parts[0] !== 'did' || parts[1] !== 'asg') {
+            return null;
+        }
+        const method = parts[1]; // "asg"
+        const submethod = parts[2]; // "agent"
+        // Chain can be multi-part (e.g., "eip155:8453")
+        // Address is always the last part
+        const address = parts[parts.length - 1];
+        const chain = parts.slice(3, parts.length - 1).join(':');
+        return { method, submethod, chain, address };
+    }
+    /**
+     * Validate that a DID string is well-formed.
+     */
+    validate(did) {
+        const parsed = this.parse(did);
+        if (!parsed)
+            return false;
+        return (parsed.method === 'asg' &&
+            parsed.submethod === 'agent' &&
+            parsed.chain.length > 0 &&
+            parsed.address.length > 0);
+    }
+    /**
+     * Update a DID Document's service endpoints.
+     */
+    updateServices(did, services) {
+        const doc = this.registry.get(did);
+        if (!doc)
+            return false;
+        doc.service = services;
+        doc.updated = new Date();
+        return true;
+    }
+    /**
+     * Deactivate (delete) a DID Document.
+     */
+    deactivate(did) {
+        return this.registry.delete(did);
+    }
+    /**
+     * List all registered DIDs.
+     */
+    listAll() {
+        return Array.from(this.registry.keys());
+    }
+    // ─── Internal ──────────────────────────────────────────────────────
+    buildDID(address, chainId) {
+        return `did:asg:agent:${chainId}:${address}`;
+    }
+    getKeyType(chainId) {
+        if (chainId.startsWith('eip155'))
+            return 'EcdsaSecp256k1VerificationKey2019';
+        if (chainId.startsWith('stellar'))
+            return 'Ed25519VerificationKey2020';
+        if (chainId.startsWith('solana'))
+            return 'Ed25519VerificationKey2020';
+        return 'JsonWebKey2020';
+    }
+    addressToMultibase(address) {
+        // Multibase-encode the address (simplified: just prefix with 'z' for base58btc)
+        return `z${address}`;
+    }
+}
+exports.DIDResolver = DIDResolver;
+//# sourceMappingURL=did-resolver.js.map

package/dist/cjs/identity/did-resolver.js.map

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