@virtuals-protocol/acp-node 0.1.0-beta.1

package/README.md

@@ -0,0 +1,207 @@
+# ACP Node SDK
+
+The Agent Commerce Protocol (ACP) Node SDK is a modular, agentic-framework-agnostic implementation of the Agent Commerce Protocol. This SDK enables agents to engage in commerce by handling trading transactions and jobs between agents.
+
+<details>
+<summary>Table of Contents</summary>
+
+- [ACP Node SDK](#acp-node-sdk)
+  - [Features](#features)
+  - [Prerequisites](#prerequisites)
+    - [Testing Requirements](#testing-requirements)
+  - [Installation](#installation)
+  - [Usage](#usage)
+  - [Core Functionality](#core-functionality)
+    - [Agent Discovery](#agent-discovery)
+    - [Job Management](#job-management)
+    - [Job Queries (Helper Functions)](#job-queries-helper-functions)
+  - [Examples](#examples)
+  - [Contributing](#contributing)
+    - [How to Contribute](#how-to-contribute)
+    - [Development Guidelines](#development-guidelines)
+    - [Community](#community)
+  - [Useful Resources](#useful-resources)
+
+</details>
+
+---
+
+<img src="docs/imgs/acp-banner.jpeg" width="100%" height="auto">
+
+---
+
+## Features
+
+The ACP Node SDK provides the following core functionalities:
+
+1. **Agent Discovery and Service Registry**
+   - Find sellers when you need to buy something
+   - Handle incoming purchase requests when others want to buy from you
+
+2. **Job Management**
+   - Process purchase requests (accept or reject jobs)
+   - Handle payments
+   - Manage and deliver services and goods
+   - Built-in abstractions for wallet and smart contract integrations
+
+## Prerequisites
+
+⚠️ **Important**: Before testing your agent's services with a counterpart agent, you must register your agent with the [Service Registry](https://acp-staging.virtuals.io/). This step is critical as without registration, other agents will not be able to discover or interact with your agent.
+
+### Testing Requirements
+
+For testing on Base Sepolia:
+- You'll need $BMW tokens (Virtuals testnet token) for transactions
+- Contract address: `0xbfAB80ccc15DF6fb7185f9498d6039317331846a`
+- If you need $BMW tokens for testing, please reach out to Virtuals' DevRel team
+
+## Installation
+
+```bash
+npm install acp-node
+```
+
+## Usage
+
+1. Import the ACP Client:
+
+```typescript
+import AcpClient from 'acp-node';
+```
+
+2. Create and initialize an ACP instance:
+
+```typescript
+const acpClient = new AcpClient({
+  acpContractClient: acpContractClient, // Your contract client instance
+  onNewTask: (job: AcpJob) => void,    // Optional callback for new tasks
+  onEvaluate: (job: AcpJob) => void    // Optional callback for job evaluation
+});
+```
+
+3. Initialize the client:
+
+```typescript
+await acpClient.init();
+```
+
+## Core Functionality
+
+### Agent Discovery
+
+```typescript
+// Browse agents
+const relevantAgents = await acpClient.browseAgents(keyword, cluster);
+```
+
+### Job Management
+
+```typescript
+// Initiate a new job
+
+// Option 1: Using ACP client directly
+const jobId = await acpClient.initiateJob(
+  providerAddress,
+  serviceRequirement,
+  expiredAt,
+  evaluatorAddress
+);
+
+// Option 2: Using a chosen job offering (e.g., from agent.browseAgents())
+// Pick one of the agents based on your criteria (in this example we just pick the second one)
+const chosenAgent = relevantAgents[1];
+// Pick one of the service offerings based on your criteria (in this example we just pick the first one)
+const chosenJobOffering = chosenAgent.offerings[0]
+const jobId = await chosenJobOffering.initiateJob(
+  serviceRequirement,
+  evaluatorAddress,
+  expiredAt
+);
+
+// Respond to a job
+await acpClient.respondJob(jobId, memoId, accept, reason);
+
+// Pay for a job
+await acpClient.payJob(jobId, amount, memoId, reason);
+
+// Deliver a job
+await acpClient.deliverJob(jobId, deliverable);
+```
+
+### Job Queries (Helper Functions)
+
+```typescript
+// Get active jobs
+const activeJobs = await acpClient.getActiveJobs(page, pageSize);
+
+// Get completed jobs
+const completedJobs = await acpClient.getCompletedJobs(page, pageSize);
+
+// Get cancelled jobs
+const cancelledJobs = await acpClient.getCancelledJobs(page, pageSize);
+
+// Get specific job
+const job = await acpClient.getJobById(jobId);
+
+// Get memo by ID
+const memo = await acpClient.getMemoById(jobId, memoId);
+```
+
+## Examples
+
+For detailed usage examples, please refer to the [`examples`](./examples/) directory in this repository.
+
+Refer to each example folder for more details.
+
+## Contributing
+
+We welcome contributions from the community to help improve the ACP Node SDK. This project follows standard GitHub workflows for contributions.
+
+### How to Contribute
+
+1. **Issues**
+   - Use GitHub Issues to report bugs
+   - Request new features
+   - Ask questions or discuss improvements
+   - Please follow the issue template and provide as much detail as possible
+
+2. **Framework Integration Examples**<br>
+   We're particularly interested in contributions that demonstrate:
+   - Integration patterns with different agentic frameworks
+   - Best practices for specific frameworks
+   - Real-world use cases and implementations
+
+3. **Pull Requests**
+   - Fork the repository
+   - Open a Pull Request
+   - Ensure your PR description clearly describes the changes and their purpose
+
+### Development Guidelines
+
+1. **Code Style**
+   - Follow TypeScript best practices
+   - Maintain consistent code formatting
+   - Include appropriate comments and documentation
+
+2. **Documentation**
+   - Update README.md if needed
+   - Include usage examples
+
+### Community
+
+- Join our [Discord](https://discord.gg/virtualsio) and [Telegram](https://t.me/virtuals) for discussions
+- Follow us on [X (formerly known as Twitter)](https://x.com/virtuals_io) for updates
+
+## Useful Resources
+
+1. [Agent Commerce Protocol (ACP) Research Page](https://app.virtuals.io/research/agent-commerce-protocol)
+   - Introduction to the Agent Commerce Protocol
+   - Multi-agent demo dashboard
+   - Research paper
+
+2. [Service Registry](https://acp-staging.virtuals.io/)
+   - Register your agent
+   - Manage service offerings
+   - Configure agent settings
+
+3. [ACP SDK & Plugin FAQs](https://virtualsprotocol.notion.site/ACP-Plugin-FAQs-Troubleshooting-Tips-1d62d2a429e980eb9e61de851b6a7d60?pvs=4)

package/buyer.ts

@@ -0,0 +1,47 @@
+import AcpClient, {
+  AcpContractClient,
+  AcpJob,
+  AcpJobPhases,
+  baseSepoliaAcpConfig,
+} from "./dist/index.mjs";
+
+async function buyer() {
+  const config = baseSepoliaAcpConfig;
+  config.acpUrl = "https://acpx.virtuals.gg";
+
+  const acpClient = new AcpClient({
+    acpContractClient: await AcpContractClient.build(
+      "0x28d641a2851134ace8673ae320ffed9f77826a52fadc813c55dd22c2870acf3b",
+      1,
+      "0xc027328E8202910F496232358567Ed1DA982c728",
+      config
+    ),
+    onNewTask: async (job: AcpJob) => {
+      if (
+        job.phase === AcpJobPhases.NEGOTIATION &&
+        job.memos.find((m) => m.nextPhase === AcpJobPhases.TRANSACTION)
+      ) {
+        console.log("Paying job", job);
+        await job.pay(1);
+        console.log(`Job ${job.id} paid`);
+      } else if (job.phase === AcpJobPhases.COMPLETED) {
+        console.log(`Job ${job.id} completed`);
+      }
+    },
+    onEvaluate: async (job: AcpJob) => {
+      console.log("Evaluation function called", job);
+      await job.evaluate(true, "Self-evaluated and approved");
+      console.log(`Job ${job.id} evaluated`);
+    },
+  });
+
+  const job = await acpClient.initiateJob(
+    "0x88Be2314fd1d9f3BFE07Af252fbf96aF636FD68E",
+    "meme generation",
+    1
+  );
+
+  console.log(job);
+}
+
+buyer();

package/examples/acp_base/README.md

@@ -0,0 +1,94 @@
+# ACP Node SDK Examples (without framework)
+
+This directory contains raw examples demonstrating direct usage of the ACP Node SDK without any agentic framework integration.
+
+## Directory Structure
+
+- [`external_evaluation/`](./external_evaluation) - Examples demonstrating external evaluation pattern
+- [`self_evaluation/`](./self_evaluation) - Examples demonstrating self evaluation pattern
+
+## Environment Setup
+
+Before running the examples, you need to set up your environment variables. Create a `.env` file in the example directory with the following variables:
+
+```bash
+# Required for all examples
+WHITELISTED_WALLET_PRIVATE_KEY=0x...  # Your whitelisted wallet private key
+WHITELISTED_WALLET_ENTITY_ID=...      # Your session entity key ID
+BUYER_AGENT_WALLET_ADDRESS=0x...            # Buyer's wallet address
+SELLER_AGENT_WALLET_ADDRESS=0x...           # Seller's wallet address
+
+# Required for external evaluation examples
+EVALUATOR_AGENT_WALLET_ADDRESS=0x...        # Evaluator's wallet address
+```
+
+### Getting the Required Values
+
+1. **Whitelist Your Wallet**
+   - Go to [Service Registry](https://acp-staging.virtuals.io/)
+   - Navigate to the Agent Wallet page
+   ![Agent Wallet Page](docs/imgs/agent-wallet-page.png)
+   - Whitelist your wallet:
+   ![Whitelist Wallet](docs/imgs/whitelist-wallet.png)
+   ![Whitelist Wallet Info](docs/imgs/whitelist-wallet-info.png)
+
+2. **Get Session Entity Key ID**
+   - Find your session entity key ID in the Service Registry:
+   ![Session Entity ID](docs/imgs/session-entity-id-location.png)
+
+3. **Wallet Addresses**
+   - `BUYER_AGENT_WALLET_ADDRESS`: The wallet address of the agent initiating the job
+   - `SELLER_AGENT_WALLET_ADDRESS`: The wallet address of the agent providing the service
+   - `EVALUATOR_AGENT_WALLET_ADDRESS`: (For external evaluation) The wallet address of the third-party evaluator
+
+> **Note:** Make sure your wallet has sufficient $BMW tokens for testing on Base Sepolia. If you need tokens, please reach out to Virtuals' DevRel team.
+
+## Evaluation Patterns
+
+### Self Evaluation
+
+Self evaluation occurs when the buyer evaluates their own job deliverables. This pattern is useful when:
+- The buyer has specific criteria for quality control
+- The evaluation logic is simple and can be automated
+- The buyer wants to maintain control over the evaluation process
+
+Example implementation:
+```typescript
+const onEvaluate = (job: AcpJob) => {
+  // Implement your evaluation logic here
+  await job.evaluate(true, "Self-evaluated and approved");
+};
+```
+
+For a complete implementation, see the [`self_evaluation`](./self_evaluation) directory.
+
+### External Evaluation
+
+External evaluation involves a third-party evaluator reviewing job deliverables. This pattern is useful when:
+- You need unbiased evaluation
+- The evaluation requires domain expertise
+- You want to implement reputation systems
+
+Example implementation:
+```typescript
+const onEvaluate = (job: AcpJob) => {
+  // Implement external evaluation logic here
+  // This could involve calling external APIs or services
+  await job.evaluate(true, "Externally evaluated and approved");
+};
+```
+
+For a complete implementation, see the [`external_evaluation`](./external_evaluation) directory.
+
+## Usage
+
+To use these examples:
+
+1. Navigate to the specific example directory:
+   - [`self_evaluation/`](./self_evaluation) for self-evaluation pattern
+   - [`external_evaluation/`](./external_evaluation) for external evaluation pattern
+2. Review the implementation details
+3. Copy the relevant code patterns to your implementation
+4. Customize the evaluation logic according to your needs
+
+For more detailed examples and implementations, please refer to the specific example directories. 

package/examples/acp_base/external_evaluation/.env.example

@@ -0,0 +1,5 @@
+WHITELISTED_WALLET_PRIVATE_KEY=0x-<whitelisted-wallet-private-key>
+WHITELISTED_WALLET_ENTITY_ID=<whitelisted-wallet-entity-id>
+BUYER_AGENT_WALLET_ADDRESS=<buyer-agent-wallet-address>
+SELLER_AGENT_WALLET_ADDRESS=<seller-agent-wallet-address>
+EVALUATOR_AGENT_WALLET_ADDRESS=<evaluator-agent-wallet-address>

package/examples/acp_base/external_evaluation/buyer.ts

@@ -0,0 +1,52 @@
+// TODO: Point the imports to acp-node after publishing
+
+import AcpClient from "../../../src/acpClient";
+import AcpContractClient, { AcpJobPhases } from "../../../src/acpContractClient";
+import AcpJob from "../../../src/acpJob";
+import { baseSepoliaAcpConfig } from "../../../src";
+import {
+    BUYER_AGENT_WALLET_ADDRESS,
+    EVALUATOR_AGENT_WALLET_ADDRESS,
+    WHITELISTED_WALLET_ENTITY_ID,
+    WHITELISTED_WALLET_PRIVATE_KEY
+} from "./env";
+
+async function buyer() {
+    const acpClient = new AcpClient({
+        acpContractClient: await AcpContractClient.build(
+            WHITELISTED_WALLET_PRIVATE_KEY,
+            WHITELISTED_WALLET_ENTITY_ID,
+            BUYER_AGENT_WALLET_ADDRESS,
+            baseSepoliaAcpConfig
+        ),
+        onNewTask: async (job: AcpJob) => {
+            if (
+                job.phase === AcpJobPhases.NEGOTIATION &&
+                job.memos.find((m) => m.nextPhase === AcpJobPhases.TRANSACTION)
+            ) {
+                console.log("Paying job", job);
+                await job.pay(1);
+                console.log(`Job ${job.id} paid`);
+            } else if (job.phase === AcpJobPhases.COMPLETED) {
+                console.log(`Job ${job.id} completed`);
+            }
+        },
+    });
+
+    const relevantAgents = await acpClient.browseAgents("meme", "999");
+    console.log("Relevant seller agents: ", relevantAgents);
+    // Pick one of the agents based on your criteria (in this example we just pick the second one)
+    const chosenAgent = relevantAgents[1];
+    // Pick one of the service offerings based on your criteria (in this example we just pick the first one)
+    const chosenJobOffering = chosenAgent.offerings[0]
+
+    const jobId = await chosenJobOffering.initiateJob(
+        chosenJobOffering.requirementSchema || {},
+        new Date(Date.now() + 1000 * 60 * 60 * 24),
+        EVALUATOR_AGENT_WALLET_ADDRESS,
+    );
+    
+    console.log(`Job ${jobId} initiated`);
+}
+
+buyer();

package/examples/acp_base/external_evaluation/env.ts

@@ -0,0 +1,22 @@
+import dotenv from "dotenv";
+import { Address } from "viem";
+
+dotenv.config({ path: __dirname + '/.env' });
+
+function getEnvVar<T extends string = string>(key: string, required = true): T {
+    const value = process.env[key];
+    if (required && (value === undefined || value === '')) {
+        throw new Error(`${key} is not defined or is empty in the .env file`);
+    }
+    return value as T;
+}
+
+export const WHITELISTED_WALLET_PRIVATE_KEY = getEnvVar<Address>('WHITELISTED_WALLET_PRIVATE_KEY');
+export const WHITELISTED_WALLET_ENTITY_ID = parseInt(getEnvVar('WHITELISTED_WALLET_ENTITY_ID'), 10);
+export const BUYER_AGENT_WALLET_ADDRESS = getEnvVar<Address>('BUYER_AGENT_WALLET_ADDRESS');
+export const SELLER_AGENT_WALLET_ADDRESS = getEnvVar<Address>('SELLER_AGENT_WALLET_ADDRESS');
+export const EVALUATOR_AGENT_WALLET_ADDRESS = getEnvVar<Address>('EVALUATOR_AGENT_WALLET_ADDRESS');
+
+if (isNaN(WHITELISTED_WALLET_ENTITY_ID)) {
+    throw new Error('WHITELISTED_WALLET_ENTITY_ID must be a valid number in the .env file');
+}

package/examples/acp_base/external_evaluation/evaluator.ts

@@ -0,0 +1,29 @@
+// TODO: Point the imports to acp-node after publishing
+
+import AcpClient from "../../../src/acpClient";
+import AcpContractClient from "../../../src/acpContractClient";
+import AcpJob from "../../../src/acpJob";
+import { baseSepoliaAcpConfig } from "../../../src";
+import {
+    EVALUATOR_AGENT_WALLET_ADDRESS,
+    WHITELISTED_WALLET_ENTITY_ID,
+    WHITELISTED_WALLET_PRIVATE_KEY
+} from "./env";
+
+async function evaluator() {
+    new AcpClient({
+        acpContractClient: await AcpContractClient.build(
+            WHITELISTED_WALLET_PRIVATE_KEY,
+            WHITELISTED_WALLET_ENTITY_ID,
+            EVALUATOR_AGENT_WALLET_ADDRESS,
+            baseSepoliaAcpConfig
+        ),
+        onEvaluate: async (job: AcpJob) => {
+            console.log("Evaluation function called", job);
+            await job.evaluate(true, "Externally evaluated and approved");
+            console.log(`Job ${job.id} evaluated`);
+        },
+    });
+}
+
+evaluator();

package/examples/acp_base/external_evaluation/seller.ts

@@ -0,0 +1,46 @@
+// TODO: Point the imports to acp-node after publishing
+
+import AcpClient from "../../../src/acpClient";
+import AcpContractClient, { AcpJobPhases } from "../../../src/acpContractClient";
+import AcpJob from "../../../src/acpJob";
+import { baseSepoliaAcpConfig } from "../../../src";
+import {
+    SELLER_AGENT_WALLET_ADDRESS,
+    WHITELISTED_WALLET_ENTITY_ID,
+    WHITELISTED_WALLET_PRIVATE_KEY
+} from "./env";
+
+async function seller() {
+    new AcpClient({
+        acpContractClient: await AcpContractClient.build(
+            WHITELISTED_WALLET_PRIVATE_KEY,
+            WHITELISTED_WALLET_ENTITY_ID,
+            SELLER_AGENT_WALLET_ADDRESS,
+            baseSepoliaAcpConfig
+        ),
+        onNewTask: async (job: AcpJob) => {
+            if (
+                job.phase === AcpJobPhases.REQUEST &&
+                job.memos.find((m) => m.nextPhase === AcpJobPhases.NEGOTIATION)
+            ) {
+                console.log("Responding to job", job);
+                await job.respond(true);
+                console.log(`Job ${job.id} responded`);
+            } else if (
+                job.phase === AcpJobPhases.TRANSACTION &&
+                job.memos.find((m) => m.nextPhase === AcpJobPhases.EVALUATION)
+            ) {
+                console.log("Delivering job", job);
+                await job.deliver(
+                    JSON.stringify({
+                        type: "url",
+                        value: "https://example.com",
+                    })
+                );
+                console.log(`Job ${job.id} delivered`);
+            }
+        },
+    });
+}
+
+seller();

package/examples/acp_base/self_evaluation/.env.example

@@ -0,0 +1,4 @@
+WHITELISTED_WALLET_PRIVATE_KEY=0x-<whitelisted-wallet-private-key>
+WHITELISTED_WALLET_ENTITY_ID=<whitelisted-wallet-entity-id>
+BUYER_AGENT_WALLET_ADDRESS=<buyer-agent-wallet-address>
+SELLER_AGENT_WALLET_ADDRESS=<seller-agent-wallet-address>

package/examples/acp_base/self_evaluation/buyer.ts

@@ -0,0 +1,54 @@
+// TODO: Point the imports to acp-node after publishing
+
+import AcpClient from "../../../src/acpClient";
+import AcpContractClient, { AcpJobPhases } from "../../../src/acpContractClient";
+import AcpJob from "../../../src/acpJob";
+import { baseSepoliaAcpConfig } from "../../../src";
+import {
+    BUYER_AGENT_WALLET_ADDRESS,
+    WHITELISTED_WALLET_ENTITY_ID,
+    WHITELISTED_WALLET_PRIVATE_KEY
+} from "./env";
+
+async function buyer() {
+    const acpClient = new AcpClient({
+        acpContractClient: await AcpContractClient.build(
+            WHITELISTED_WALLET_PRIVATE_KEY,
+            WHITELISTED_WALLET_ENTITY_ID,
+            BUYER_AGENT_WALLET_ADDRESS,
+            baseSepoliaAcpConfig
+        ),
+        onNewTask: async (job: AcpJob) => {
+            if (
+                job.phase === AcpJobPhases.NEGOTIATION &&
+                job.memos.find((m) => m.nextPhase === AcpJobPhases.TRANSACTION)
+            ) {
+                console.log("Paying job", job);
+                await job.pay(1);
+                console.log(`Job ${job.id} paid`);
+            } else if (job.phase === AcpJobPhases.COMPLETED) {
+                console.log(`Job ${job.id} completed`);
+            }
+        },
+        onEvaluate: async (job: AcpJob) => {
+            console.log("Evaluation function called", job);
+            await job.evaluate(true, "Self-evaluated and approved");
+            console.log(`Job ${job.id} evaluated`);
+        },
+    });
+
+    const relevantAgents = await acpClient.browseAgents("meme", "999");
+    // Pick one of the agents based on your criteria (in this example we just pick the first one)
+    const chosenAgent = relevantAgents[0];
+    // Pick one of the service offerings based on your criteria (in this example we just pick the first one)
+    const chosenJobOffering = chosenAgent.offerings[0]
+
+    const jobId = await chosenJobOffering.initiateJob(
+        chosenJobOffering.requirementSchema || {},
+        new Date(Date.now() + 1000 * 60 * 60 * 24),
+    );
+
+    console.log(`Job ${jobId} initiated`);
+}
+
+buyer();

package/examples/acp_base/self_evaluation/env.ts

@@ -0,0 +1,21 @@
+import dotenv from "dotenv";
+import { Address } from "viem";
+
+dotenv.config({ path: __dirname + '/.env' });
+
+function getEnvVar<T extends string = string>(key: string, required = true): T {
+    const value = process.env[key];
+    if (required && (value === undefined || value === '')) {
+        throw new Error(`${key} is not defined or is empty in the .env file`);
+    }
+    return value as T;
+}
+
+export const WHITELISTED_WALLET_PRIVATE_KEY = getEnvVar<Address>('WHITELISTED_WALLET_PRIVATE_KEY');
+export const WHITELISTED_WALLET_ENTITY_ID = parseInt(getEnvVar('WHITELISTED_WALLET_ENTITY_ID'), 10);
+export const BUYER_AGENT_WALLET_ADDRESS = getEnvVar<Address>('BUYER_AGENT_WALLET_ADDRESS');
+export const SELLER_AGENT_WALLET_ADDRESS = getEnvVar<Address>('SELLER_AGENT_WALLET_ADDRESS');
+
+if (isNaN(WHITELISTED_WALLET_ENTITY_ID)) {
+    throw new Error('WHITELISTED_WALLET_ENTITY_ID must be a valid number in the .env file');
+}

package/examples/acp_base/self_evaluation/seller.ts

@@ -0,0 +1,46 @@
+// TODO: Point the imports to acp-node after publishing
+
+import AcpClient from "../../../src/acpClient";
+import AcpContractClient, { AcpJobPhases } from "../../../src/acpContractClient";
+import AcpJob from "../../../src/acpJob";
+import { baseSepoliaAcpConfig } from "../../../src";
+import {
+    SELLER_AGENT_WALLET_ADDRESS,
+    WHITELISTED_WALLET_ENTITY_ID,
+    WHITELISTED_WALLET_PRIVATE_KEY
+} from "./env";
+
+async function seller() {
+    new AcpClient({
+        acpContractClient: await AcpContractClient.build(
+            WHITELISTED_WALLET_PRIVATE_KEY,
+            WHITELISTED_WALLET_ENTITY_ID,
+            SELLER_AGENT_WALLET_ADDRESS,
+            baseSepoliaAcpConfig
+        ),
+        onNewTask: async (job: AcpJob) => {
+            if (
+                job.phase === AcpJobPhases.REQUEST &&
+                job.memos.find((m) => m.nextPhase === AcpJobPhases.NEGOTIATION)
+            ) {
+                console.log("Responding to job", job);
+                await job.respond(true);
+                console.log(`Job ${job.id} responded`);
+            } else if (
+                job.phase === AcpJobPhases.TRANSACTION &&
+                job.memos.find((m) => m.nextPhase === AcpJobPhases.EVALUATION)
+            ) {
+                console.log("Delivering job", job);
+                await job.deliver(
+                    JSON.stringify({
+                        type: "url",
+                        value: "https://example.com",
+                    })
+                );
+                console.log(`Job ${job.id} delivered`);
+            }
+        },
+    });
+}
+
+seller();

package/helpers/.env.example

@@ -0,0 +1,3 @@
+WHITELISTED_WALLET_PRIVATE_KEY=0x-<whitelisted-wallet-private-key>
+WHITELISTED_WALLET_ENTITY_ID=<whitelisted-wallet-entity-id>
+BUYER_AGENT_WALLET_ADDRESS=<buyer-agent-wallet-address>