@0xward/twinpayai-client

An automated payment initialization client designed to enable autonomous software entities to programmatically dispatch and audit digital currency transfers on the Stacks layer-2 environment.

Installation

Prerequisites

• Node.js >= 18.0.0
• npm >= 9.0.0 (or yarn >= 1.22.0 / pnpm >= 8.0.0)

Package Deployment

Execute the targeted acquisition command matching your production environment package manager setup:

# Using Node Package Manager (Default)
npm install @0xward/twinpayai-client

# Using Yarn Package Manager
yarn add @0xward/twinpayai-client

# Using PNPM Package Manager
pnpm add @0xward/twinpayai-client

Peer Dependencies

For secure runtime cryptographic executions and ledger state mutations, ensure your runtime container establishes communication boundaries with the primary network bindings if processing on-chain blocks:

• For Stacks L2 layers: @stacks/transactions (>= 6.x) and @stacks/common for atomic cryptographically signed payload routing.

Core Capabilities

• Autonomous Fee Profiling: Computes native transaction fee limits to maximize inclusion speed on the underlying Bitcoin miners network.
• Cryptographic Payload Signing: Signs payment objects via client-side keys conforming to institutional message structures.
• Settlement State Telemetry: Streams transactional progression metrics from immediate memory pool status to final Bitcoin anchoring.

Quick Start

const { TwinPayClient } = require("@0xward/twinpayai-client");
const client = new TwinPayClient();

async function processPayment() {
    const result = await client.initiateAiPayment("0xward.btc", 50.00);
    console.log("Transaction Receipt Parameters:", result);
}
processPayment();

API Reference

Methods

| Method | Parameters | Return Type | Description | | :--- | :--- | :--- | :--- | | initiateAiPayment | recipient: string, amountUsd: number | Promise<Object> | Builds and passes a signed financial request payload to the active network nodes. | | getTransactionStatus | txHash: string | Promise<Object> | Pulls ledger block numbers to return absolute confirmation state details. |

License

This project is licensed under the terms of the MIT License.