@ghostspeak/sdk 2.0.7 → 2.0.10

package/dist/minimal/core-minimal.d.ts

@@ -1,6 +1,5 @@
 import { Address, Option, ReadonlyUint8Array, AccountMeta, Instruction, InstructionWithData, InstructionWithAccounts, WritableAccount, WritableSignerAccount, AccountSignerMeta, ReadonlyAccount, Commitment as Commitment$1, Rpc, GetLatestBlockhashApi, SendTransactionApi, GetAccountInfoApi, SimulateTransactionApi, GetFeeForMessageApi, GetProgramAccountsApi, GetEpochInfoApi, GetSignatureStatusesApi, GetMultipleAccountsApi, RpcSubscriptions, SignatureNotificationsApi, SlotNotificationsApi, AccountRole, TransactionSigner, Signature as Signature$1 } from '@solana/kit';
 import { Address as Address$1 } from '@solana/addresses';
-import { EventEmitter } from 'node:events';
 
 /**
  * This code was AUTOGENERATED using the Codama library.
@@ -19,6 +18,22 @@ declare enum AccessTier {
     Whale = 4
 }
 
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+
+/** Agent lifecycle status (Ghost Identity) */
+declare enum AgentStatus {
+    Unregistered = 0,
+    Registered = 1,
+    Claimed = 2,
+    Verified = 3
+}
+
 /**
  * This code was AUTOGENERATED using the Codama library.
  * Please DO NOT EDIT THIS FILE, instead use visitors
@@ -150,6 +165,22 @@ type ExecutionParamsArgs = {
     executionAuthority: Address;
 };
 
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+
+/** Cross-platform identity mapping */
+type ExternalIdentifier = {
+    platform: string;
+    externalId: string;
+    verified: boolean;
+    verifiedAt: bigint;
+};
+
 /**
  * This code was AUTOGENERATED using the Codama library.
  * Please DO NOT EDIT THIS FILE, instead use visitors
@@ -370,6 +401,43 @@ type QuorumRequirements = {
     quorumMethod: QuorumMethod;
 };
 
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+
+/** Reputation component for multi-source Ghost Score */
+type ReputationComponent = {
+    sourceType: ReputationSourceType;
+    score: bigint;
+    weight: number;
+    lastUpdated: bigint;
+    dataPoints: bigint;
+};
+
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+
+/** Multi-source reputation types for Ghost Score */
+declare enum ReputationSourceType {
+    AccountAge = 0,
+    X402Transactions = 1,
+    UserReviews = 2,
+    ElizaOSReputation = 3,
+    CrossmintVerification = 4,
+    EndpointReliability = 5,
+    JobCompletions = 6,
+    SkillEndorsements = 7
+}
+
 /**
  * This code was AUTOGENERATED using the Codama library.
  * Please DO NOT EDIT THIS FILE, instead use visitors
@@ -449,8 +517,13 @@ type VotingResults = {
 
 type Agent$1 = {
     discriminator: ReadonlyUint8Array;
-    owner: Address;
+    owner: Option<Address>;
+    status: AgentStatus;
     agentId: string;
+    firstTxSignature: string;
+    firstSeenTimestamp: bigint;
+    discoverySource: string;
+    claimedAt: Option<bigint>;
     agentType: number;
     name: string;
     description: string;
@@ -486,6 +559,11 @@ type Agent$1 = {
     x402TotalPayments: bigint;
     x402TotalCalls: bigint;
     lastPaymentTimestamp: bigint;
+    externalIdentifiers: Array<ExternalIdentifier>;
+    ghostScore: bigint;
+    reputationComponents: Array<ReputationComponent>;
+    didAddress: Option<Address>;
+    credentials: Array<Address>;
     apiSpecUri: string;
     apiVersion: string;
     bump: number;
@@ -623,89 +701,6 @@ type InitializeGovernanceProposalInstruction<TProgram extends string = typeof GH
     ...TRemainingAccounts
 ]>;
 
-/**
- * PayAI Integration Types
- *
- * Type definitions for PayAI x402 facilitator integration,
- * including webhook payloads and client configuration.
- *
- * @module payai/types
- * @see https://docs.payai.network/x402/introduction
- */
-
-/**
- * PayAI supported networks
- */
-type PayAINetwork = 'solana' | 'base' | 'ethereum' | 'polygon' | 'arbitrum';
-/**
- * PayAI client configuration
- */
-interface PayAIClientConfig {
-    /** PayAI facilitator URL (default: https://facilitator.payai.network) */
-    facilitatorUrl?: string;
-    /** Solana RPC endpoint */
-    rpcUrl: string;
-    /** User wallet for signing payments */
-    wallet?: {
-        publicKey: string;
-        signTransaction: (tx: unknown) => Promise<unknown>;
-    };
-    /** Request timeout in milliseconds */
-    timeout?: number;
-    /** Retry configuration */
-    retry?: {
-        attempts: number;
-        delayMs: number;
-    };
-}
-/**
- * x402 payment requirement from a resource
- */
-interface PayAIPaymentRequirement {
-    /** Payment scheme (e.g., 'exact') */
-    scheme: string;
-    /** Blockchain network */
-    network: PayAINetwork;
-    /** Maximum amount required in smallest unit */
-    maxAmountRequired: string;
-    /** Resource URL */
-    resource: string;
-    /** Description of the resource */
-    description?: string;
-    /** MIME type of the response */
-    mimeType?: string;
-    /** Recipient address */
-    payTo: string;
-    /** Token/asset address */
-    asset: string;
-    /** Maximum timeout in seconds */
-    maxTimeoutSeconds?: number;
-    /** Additional data */
-    extra?: Record<string, unknown>;
-}
-/**
- * Data to record for reputation tracking
- * Extracted from PayAI webhook payloads
- */
-interface PayAIReputationRecord {
-    /** Agent/Merchant address on Solana */
-    agentAddress: Address$1;
-    /** Payment signature for verification */
-    paymentSignature: string;
-    /** Payment amount */
-    amount: bigint;
-    /** Whether the service was successful */
-    success: boolean;
-    /** Response time in milliseconds */
-    responseTimeMs: number;
-    /** Payer address */
-    payerAddress: string;
-    /** Timestamp of payment */
-    timestamp: Date;
-    /** Network the payment was on */
-    network: PayAINetwork;
-}
-
 /**
  * CacheManager - Slot-aware RPC result caching
  *
@@ -1318,8 +1313,6 @@ interface GhostSpeakConfig {
     ipfsConfig?: IPFSConfig;
     /** Credential configuration for Crossmint sync */
     credentials?: CredentialConfig;
-    /** PayAI configuration */
-    payai?: Partial<PayAIClientConfig>;
 }
 interface CredentialConfig {
     crossmintApiKey?: string;
@@ -1808,6 +1801,183 @@ declare class AgentModule extends BaseModule {
     private get compressionProgramId();
 }
 
+/**
+ * Ghost Module - Claim and manage external AI agents
+ *
+ * This module provides methods for claiming "Ghost" agents (external agents
+ * registered on x402 facilitators like PayAI) using the Solana Attestation
+ * Service (SAS) for trustless ownership verification.
+ */
+
+/**
+ * Network identifier for DID generation
+ */
+type Network = 'devnet' | 'testnet' | 'mainnet-beta' | 'localnet';
+/**
+ * Parameters for claiming a Ghost
+ */
+interface ClaimGhostParams {
+    /** Agent account address (the external agent to claim) */
+    agentAddress: Address$1;
+    /** x402 payment address of the agent (used for PDA derivation) */
+    x402PaymentAddress: Address$1;
+    /** SAS Credential address (issuer) */
+    sasCredential: Address$1;
+    /** SAS Schema address (defines attestation structure) */
+    sasSchema: Address$1;
+    /** Network identifier for DID (e.g., "devnet", "mainnet-beta") */
+    network: Network;
+    /** Optional IPFS metadata URI (ipfs://...) */
+    ipfsMetadataUri?: string;
+    /** Optional GitHub username for social proof */
+    githubUsername?: string;
+    /** Optional Twitter handle for social proof */
+    twitterHandle?: string;
+}
+/**
+ * Result of preparing a Ghost claim
+ */
+interface PreparedClaimResult {
+    /** Derived attestation PDA */
+    attestationPda: Address$1;
+    /** Derived DID document PDA */
+    didDocumentPda: Address$1;
+    /** Attestation bump seed */
+    attestationBump: number;
+    /** DID document bump seed */
+    didDocumentBump: number;
+}
+/**
+ * Ghost Module - Manage external agent claims
+ */
+declare class GhostModule extends BaseModule {
+    constructor(config: GhostSpeakConfig);
+    /**
+     * Claim ownership of a Ghost using SAS attestation
+     *
+     * This method performs the complete claim flow:
+     * 1. Derives required PDAs (attestation, DID document)
+     * 2. Builds the claim_ghost instruction
+     * 3. Executes the transaction
+     *
+     * **Prerequisites:**
+     * - The claimer must have already created a SAS attestation proving ownership
+     *   of the agent's x402_payment_address
+     * - The agent must be in Unregistered or Registered status (not already claimed)
+     *
+     * **Results:**
+     * - Agent status transitions to Claimed
+     * - DID document is auto-created with did:sol:<network>:<address>
+     * - Claimer becomes the owner of the agent
+     *
+     * @param claimer - Transaction signer (must own the SAS attestation)
+     * @param params - Claim parameters
+     * @returns Transaction signature
+     *
+     * @example
+     * ```typescript
+     * const signature = await client.ghosts.claim(signer, {
+     *   agentAddress: 'GhostAgent123...',
+     *   x402PaymentAddress: 'PaymentAddr456...',
+     *   sasCredential: 'SASCredential789...',
+     *   sasSchema: 'SASSchema012...',
+     *   network: 'devnet',
+     *   ipfsMetadataUri: 'ipfs://QmHash...',
+     *   githubUsername: 'myusername'
+     * })
+     * ```
+     */
+    claim(claimer: TransactionSigner, params: ClaimGhostParams): Promise<string>;
+    /**
+     * Prepare a Ghost claim by deriving all required PDAs
+     *
+     * This is useful for:
+     * - Pre-flight validation (checking if PDAs are correct)
+     * - Building custom transactions with manual PDA management
+     * - Debugging claim issues
+     *
+     * @param params - Claim parameters
+     * @returns Prepared claim data with derived PDAs
+     *
+     * @example
+     * ```typescript
+     * const prepared = await client.ghosts.prepareClaim({
+     *   agentAddress: 'GhostAgent123...',
+     *   x402PaymentAddress: 'PaymentAddr456...',
+     *   sasCredential: 'SASCredential789...',
+     *   sasSchema: 'SASSchema012...',
+     *   network: 'devnet'
+     * })
+     *
+     * console.log('Attestation PDA:', prepared.attestationPda)
+     * console.log('DID Document PDA:', prepared.didDocumentPda)
+     * ```
+     */
+    prepareClaim(params: ClaimGhostParams): Promise<PreparedClaimResult>;
+    /**
+     * Get Ghost agent account
+     *
+     * @param address - Agent account address
+     * @returns Agent account data or null if not found
+     */
+    getGhostAgent(address: Address$1): Promise<Agent$1 | null>;
+    /**
+     * Get all Ghost agents (agents with type 10 - external x402 agents)
+     *
+     * @returns Array of Ghost agents
+     */
+    getAllGhosts(): Promise<{
+        address: Address$1;
+        data: Agent$1;
+    }[]>;
+    /**
+     * Get Ghost agents by type
+     *
+     * @param agentType - Agent type filter (default: 10 for x402 ghosts)
+     * @returns Array of matching Ghost agents
+     */
+    getGhostsByType(agentType?: number): Promise<{
+        address: Address$1;
+        data: Agent$1;
+    }[]>;
+    /**
+     * Get claimed Ghosts by owner
+     *
+     * @param owner - Owner address
+     * @returns Array of Ghost agents owned by the address
+     */
+    getClaimedGhosts(owner: Address$1): Promise<{
+        address: Address$1;
+        data: Agent$1;
+    }[]>;
+    /**
+     * Validate claim parameters
+     *
+     * Performs pre-flight checks to ensure claim will succeed:
+     * - Agent exists and is in correct status
+     * - Agent is not already claimed
+     * - PDAs are correctly derived
+     *
+     * @param params - Claim parameters
+     * @returns Validation result with error messages if any
+     */
+    validateClaim(params: ClaimGhostParams): Promise<{
+        valid: boolean;
+        errors: string[];
+        warnings: string[];
+    }>;
+    /**
+     * Derive DID document PDA
+     *
+     * Pattern: ['did_document', x402_payment_address]
+     *
+     * @param x402PaymentAddress - Agent's x402 payment address
+     * @returns [DID document PDA, bump]
+     */
+    private deriveDidDocumentPda;
+    private get systemProgramId();
+}
+
 /**
  * Governance management module
  *
@@ -2402,98 +2572,6 @@ declare class UnifiedCredentialService {
     }): Promise<IssuedCredentialResult>;
 }
 
-/**
- * PayAI x402 Client
- *
- * Client for making x402 payments through the PayAI facilitator.
- * Wraps the standard fetch API with automatic payment handling.
- *
- * @module payai/PayAIClient
- * @see https://docs.payai.network/x402/introduction
- */
-
-declare class PayAIClient extends EventEmitter {
-    private readonly config;
-    private readonly localRecords;
-    constructor(config: PayAIClientConfig);
-    /**
-     * Make a fetch request with automatic x402 payment handling
-     *
-     * @param url - The resource URL
-     * @param init - Fetch options
-     * @returns Response from the resource
-     */
-    fetch(url: string, init?: RequestInit): Promise<Response>;
-    /**
-     * Verify a payment through the PayAI facilitator
-     *
-     * @param paymentHeader - The payment header/payload
-     * @param requirement - The payment requirement
-     * @returns Verification result
-     */
-    verifyPayment(paymentHeader: string, requirement: PayAIPaymentRequirement): Promise<{
-        valid: boolean;
-        payer?: string;
-        error?: string;
-    }>;
-    /**
-     * Settle a payment through the PayAI facilitator
-     *
-     * @param paymentHeader - The payment header/payload
-     * @param requirement - The payment requirement
-     * @returns Settlement result
-     */
-    settlePayment(paymentHeader: string, requirement: PayAIPaymentRequirement): Promise<{
-        success: boolean;
-        transaction?: string;
-        error?: string;
-    }>;
-    /**
-     * List available resources from the PayAI facilitator
-     *
-     * @param options - Filter options
-     * @returns List of available resources
-     */
-    listResources(options?: {
-        network?: PayAINetwork;
-        capability?: string;
-        maxPrice?: number;
-    }): Promise<{
-        resources: Array<{
-            url: string;
-            description?: string;
-            accepts: PayAIPaymentRequirement[];
-            tags?: string[];
-        }>;
-    }>;
-    /**
-     * Get locally tracked reputation records
-     * (For payments made through this client instance)
-     */
-    getLocalReputationRecords(): PayAIReputationRecord[];
-    /**
-     * Clear local reputation records
-     */
-    clearLocalReputationRecords(): void;
-    /**
-     * Select the best payment option from requirements
-     */
-    private selectPaymentOption;
-    /**
-     * Make payment and retry the original request
-     */
-    private makePaymentAndRetry;
-    /**
-     * Create a payment header for a requirement
-     * (In production, this would sign a real Solana transaction)
-     */
-    private createPaymentHeader;
-    /**
-     * Fetch with timeout
-     */
-    private fetchWithTimeout;
-}
-
 /**
  * Reputation tier levels
  */
@@ -3194,11 +3272,6 @@ interface CreateAuthorizationParams {
     nonce?: string;
     /** Optional metadata */
     metadata?: AuthorizationMetadata;
-    /**
-     * Whether to store authorization on-chain (default: false)
-     * @deprecated Use onChainStorage.enabled instead
-     */
-    storeOnChain?: boolean;
     /**
      * On-chain storage configuration
      * If not provided, defaults to off-chain (free) storage
@@ -3589,6 +3662,14 @@ declare class GhostSpeakClient {
      * Direct access to Agent Module for read operations
      */
     get agents(): AgentModule;
+    /**
+     * Direct access to Ghost Module for claiming external agents
+     *
+     * Ghosts are external AI agents (type 10) that exist on x402 facilitators.
+     * They can be claimed using Solana Attestation Service (SAS)
+     * for trustless ownership verification.
+     */
+    get ghosts(): GhostModule;
     /**
      * Direct access to Governance Module for read operations
      */
@@ -3601,10 +3682,6 @@ declare class GhostSpeakClient {
      * Agent operations
      */
     agent(): AgentBuilder;
-    /**
-     * PayAI operations (x402 payments)
-     */
-    payai(): PayAIClient;
     /**
      * Reputation operations
      */
@@ -3619,7 +3696,7 @@ declare class GhostSpeakClient {
     /**
      * Multi-Source Reputation Aggregator (Pillar 3: External Sources)
      *
-     * Aggregate reputation data from multiple sources (PayAI, GitHub, custom webhooks)
+     * Aggregate reputation data from multiple sources (x402, GitHub, custom webhooks)
      * with weighted scoring and conflict detection.
      */
     reputationAggregator(): any;