@sequence0/sdk 1.1.2 → 1.2.0

package/dist/chains/near.js

@@ -0,0 +1,170 @@
+"use strict";
+/**
+ * Near Chain Adapter
+ *
+ * Builds Near Protocol transactions using Borsh serialization,
+ * attaches Ed25519 signatures from the FROST threshold signing
+ * network, and broadcasts via Near JSON RPC.
+ *
+ * Requires: npm install near-api-js
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NearAdapter = void 0;
+exports.createNearAdapter = createNearAdapter;
+exports.createNearTestnetAdapter = createNearTestnetAdapter;
+const errors_1 = require("../utils/errors");
+const optional_deps_1 = require("../utils/optional-deps");
+const DEFAULT_RPCS = {
+    'mainnet': 'https://rpc.mainnet.near.org',
+    'testnet': 'https://rpc.testnet.near.org',
+};
+class NearAdapter {
+    constructor(network = 'mainnet', rpcUrl) {
+        this.network = network;
+        this.rpcUrl = rpcUrl || DEFAULT_RPCS[network];
+        this.nearApi = (0, optional_deps_1.requireOptionalDependency)('near-api-js', 'near');
+    }
+    getRpcUrl() {
+        return this.rpcUrl;
+    }
+    /**
+     * Build an unsigned Near transaction.
+     *
+     * Near uses Borsh serialization. The signing payload is
+     * SHA-256 of the Borsh-serialized Transaction object.
+     */
+    async buildTransaction(tx, fromAddress) {
+        try {
+            const { connect, keyStores, transactions, utils } = this.nearApi;
+            // Connect to get access key info (nonce, block hash)
+            const near = await connect({
+                networkId: this.network,
+                nodeUrl: this.rpcUrl,
+                keyStore: new keyStores.InMemoryKeyStore(),
+            });
+            const provider = near.connection.provider;
+            // Get access key for nonce
+            const accessKeyInfo = await provider.query({
+                request_type: 'view_access_key',
+                account_id: fromAddress,
+                public_key: '', // Will use the wallet's public key
+                finality: 'final',
+            }).catch(() => ({ nonce: 0 }));
+            const nonce = accessKeyInfo.nonce + 1;
+            // Get recent block hash for replay protection
+            const block = await provider.block({ finality: 'final' });
+            const blockHash = utils.serialize.base_decode(block.header.hash);
+            // Build transfer action
+            const actions = [transactions.transfer(BigInt(tx.amount))];
+            // Create the transaction
+            const transaction = transactions.createTransaction(fromAddress, utils.PublicKey.from('ed25519:' + '0'.repeat(64)), // placeholder
+            tx.to, nonce, actions, blockHash);
+            // Serialize and hash
+            const serialized = utils.serialize.serialize(transactions.SCHEMA.Transaction ?? transactions.SCHEMA, transaction);
+            const crypto = require('crypto');
+            const signingHash = crypto.createHash('sha256').update(Buffer.from(serialized)).digest();
+            const payload = {
+                signingHash: Buffer.from(signingHash).toString('hex'),
+                serialized: Buffer.from(serialized).toString('hex'),
+                fromAddress,
+                toAddress: tx.to,
+                amount: tx.amount,
+                nonce,
+                blockHash: Buffer.from(blockHash).toString('hex'),
+            };
+            return Buffer.from(JSON.stringify(payload)).toString('hex');
+        }
+        catch (e) {
+            if (e instanceof errors_1.ChainError)
+                throw e;
+            throw new errors_1.ChainError(`Failed to build Near transaction: ${e.message}`, 'near');
+        }
+    }
+    getSigningPayload(unsignedTx) {
+        try {
+            const payload = JSON.parse(Buffer.from(unsignedTx, 'hex').toString());
+            return payload.signingHash;
+        }
+        catch {
+            return unsignedTx;
+        }
+    }
+    /**
+     * Attach an Ed25519 signature to the Near transaction
+     */
+    async attachSignature(unsignedTx, signature) {
+        try {
+            const payload = JSON.parse(Buffer.from(unsignedTx, 'hex').toString());
+            const sig = signature.startsWith('0x') ? signature.slice(2) : signature;
+            const signedPayload = {
+                ...payload,
+                signature: sig, // 64-byte Ed25519 signature
+            };
+            return Buffer.from(JSON.stringify(signedPayload)).toString('hex');
+        }
+        catch (e) {
+            throw new errors_1.ChainError(`Failed to attach Near signature: ${e.message}`, 'near');
+        }
+    }
+    /**
+     * Broadcast a signed Near transaction
+     */
+    async broadcast(signedTx) {
+        try {
+            const { connect, keyStores, transactions, utils } = this.nearApi;
+            const payload = JSON.parse(Buffer.from(signedTx, 'hex').toString());
+            const near = await connect({
+                networkId: this.network,
+                nodeUrl: this.rpcUrl,
+                keyStore: new keyStores.InMemoryKeyStore(),
+            });
+            const provider = near.connection.provider;
+            // Reconstruct signed transaction
+            const serializedTx = Buffer.from(payload.serialized, 'hex');
+            const sigBytes = Buffer.from(payload.signature, 'hex');
+            // Build the signed transaction bytes (transaction + signature)
+            const signedTxBytes = Buffer.concat([
+                serializedTx,
+                Buffer.from([0]), // Ed25519 key type
+                sigBytes,
+            ]);
+            // Send via RPC
+            const result = await provider.sendJsonRpc('broadcast_tx_commit', [
+                Buffer.from(signedTxBytes).toString('base64'),
+            ]);
+            return result.transaction?.hash || '';
+        }
+        catch (e) {
+            if (e instanceof errors_1.ChainError)
+                throw e;
+            throw new errors_1.ChainError(`Failed to broadcast Near tx: ${e.message}`, 'near');
+        }
+    }
+    /**
+     * Get NEAR balance in yoctoNEAR
+     */
+    async getBalance(address) {
+        try {
+            const { connect, keyStores } = this.nearApi;
+            const near = await connect({
+                networkId: this.network,
+                nodeUrl: this.rpcUrl,
+                keyStore: new keyStores.InMemoryKeyStore(),
+            });
+            const account = await near.account(address);
+            const balance = await account.getAccountBalance();
+            return balance.available;
+        }
+        catch {
+            return '0';
+        }
+    }
+}
+exports.NearAdapter = NearAdapter;
+function createNearAdapter(rpcUrl) {
+    return new NearAdapter('mainnet', rpcUrl);
+}
+function createNearTestnetAdapter(rpcUrl) {
+    return new NearAdapter('testnet', rpcUrl);
+}
+//# sourceMappingURL=near.js.map

package/dist/chains/near.js.map

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

package/dist/chains/polkadot.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Polkadot Chain Adapter
+ *
+ * Builds Polkadot extrinsics using SCALE codec, attaches Ed25519
+ * signatures from the FROST threshold signing network, and broadcasts
+ * via Polkadot JSON RPC.
+ *
+ * Uses Ed25519 key type (not sr25519) for FROST compatibility.
+ *
+ * Requires: npm install @polkadot/api
+ */
+import { ChainAdapter, PolkadotTransaction } from '../core/types';
+export declare class PolkadotAdapter implements ChainAdapter {
+    private rpcUrl;
+    private network;
+    private polkadotApi;
+    constructor(network?: 'mainnet' | 'westend' | 'kusama', rpcUrl?: string);
+    getRpcUrl(): string;
+    /**
+     * Build an unsigned Polkadot balance transfer extrinsic.
+     *
+     * The signing payload is SCALE-encoded ExtrinsicPayload.
+     * If payload > 256 bytes, it's hashed with Blake2b-256 before signing.
+     */
+    buildTransaction(tx: PolkadotTransaction, fromAddress: string): Promise<string>;
+    getSigningPayload(unsignedTx: string): string;
+    /**
+     * Attach an Ed25519 signature to the Polkadot extrinsic
+     */
+    attachSignature(unsignedTx: string, signature: string): Promise<string>;
+    /**
+     * Broadcast a signed Polkadot extrinsic
+     */
+    broadcast(signedTx: string): Promise<string>;
+    /**
+     * Get DOT balance in planck
+     */
+    getBalance(address: string): Promise<string>;
+}
+export declare function createPolkadotAdapter(rpcUrl?: string): PolkadotAdapter;
+export declare function createKusamaAdapter(rpcUrl?: string): PolkadotAdapter;
+export declare function createPolkadotWestendAdapter(rpcUrl?: string): PolkadotAdapter;
+//# sourceMappingURL=polkadot.d.ts.map

package/dist/chains/polkadot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polkadot.d.ts","sourceRoot":"","sources":["../../src/chains/polkadot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAUlE,qBAAa,eAAgB,YAAW,YAAY;IAChD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAM;gBAEb,OAAO,GAAE,SAAS,GAAG,SAAS,GAAG,QAAoB,EAAE,MAAM,CAAC,EAAE,MAAM;IAMlF,SAAS,IAAI,MAAM;IAInB;;;;;OAKG;IACG,gBAAgB,CAAC,EAAE,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA+DrF,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAS7C;;OAEG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAmB7E;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAuClD;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAYrD;AAED,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,eAAe,CAEtE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,eAAe,CAEpE;AAED,wBAAgB,4BAA4B,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,eAAe,CAE7E"}

package/dist/chains/polkadot.js

@@ -0,0 +1,179 @@
+"use strict";
+/**
+ * Polkadot Chain Adapter
+ *
+ * Builds Polkadot extrinsics using SCALE codec, attaches Ed25519
+ * signatures from the FROST threshold signing network, and broadcasts
+ * via Polkadot JSON RPC.
+ *
+ * Uses Ed25519 key type (not sr25519) for FROST compatibility.
+ *
+ * Requires: npm install @polkadot/api
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PolkadotAdapter = void 0;
+exports.createPolkadotAdapter = createPolkadotAdapter;
+exports.createKusamaAdapter = createKusamaAdapter;
+exports.createPolkadotWestendAdapter = createPolkadotWestendAdapter;
+const errors_1 = require("../utils/errors");
+const optional_deps_1 = require("../utils/optional-deps");
+const DEFAULT_RPCS = {
+    'mainnet': 'wss://rpc.polkadot.io',
+    'westend': 'wss://westend-rpc.polkadot.io',
+    'kusama': 'wss://kusama-rpc.polkadot.io',
+};
+class PolkadotAdapter {
+    constructor(network = 'mainnet', rpcUrl) {
+        this.network = network;
+        this.rpcUrl = rpcUrl || DEFAULT_RPCS[network];
+        this.polkadotApi = (0, optional_deps_1.requireOptionalDependency)('@polkadot/api', 'polkadot');
+    }
+    getRpcUrl() {
+        return this.rpcUrl;
+    }
+    /**
+     * Build an unsigned Polkadot balance transfer extrinsic.
+     *
+     * The signing payload is SCALE-encoded ExtrinsicPayload.
+     * If payload > 256 bytes, it's hashed with Blake2b-256 before signing.
+     */
+    async buildTransaction(tx, fromAddress) {
+        try {
+            const { ApiPromise, WsProvider } = this.polkadotApi;
+            const provider = new WsProvider(this.rpcUrl);
+            const api = await ApiPromise.create({ provider });
+            // Create the transfer extrinsic
+            const transfer = api.tx.balances.transferKeepAlive(tx.to, BigInt(tx.amount));
+            // Get signing parameters
+            const nonce = await api.rpc.system.accountNextIndex(fromAddress);
+            const blockHash = await api.rpc.chain.getBlockHash();
+            const genesisHash = api.genesisHash;
+            const runtimeVersion = api.runtimeVersion;
+            // Create the signing payload
+            const signingPayload = api.createType('ExtrinsicPayload', {
+                method: transfer.method,
+                nonce: nonce.toNumber(),
+                specVersion: runtimeVersion.specVersion,
+                transactionVersion: runtimeVersion.transactionVersion,
+                genesisHash,
+                blockHash,
+                era: api.createType('ExtrinsicEra', { current: 0, period: 64 }),
+                tip: 0,
+            });
+            const payloadU8a = signingPayload.toU8a({ method: true });
+            // If payload > 256 bytes, hash with Blake2b-256
+            let signingHash;
+            if (payloadU8a.length > 256) {
+                const crypto = require('crypto');
+                signingHash = crypto.createHash('sha256').update(Buffer.from(payloadU8a)).digest();
+            }
+            else {
+                signingHash = Buffer.from(payloadU8a);
+            }
+            const payload = {
+                signingHash: signingHash.toString('hex'),
+                method: transfer.method.toHex(),
+                nonce: nonce.toNumber(),
+                specVersion: runtimeVersion.specVersion.toNumber(),
+                transactionVersion: runtimeVersion.transactionVersion.toNumber(),
+                genesisHash: genesisHash.toHex(),
+                blockHash: blockHash.toHex(),
+                fromAddress,
+                toAddress: tx.to,
+                amount: tx.amount,
+            };
+            await api.disconnect();
+            return Buffer.from(JSON.stringify(payload)).toString('hex');
+        }
+        catch (e) {
+            if (e instanceof errors_1.ChainError)
+                throw e;
+            throw new errors_1.ChainError(`Failed to build Polkadot transaction: ${e.message}`, 'polkadot');
+        }
+    }
+    getSigningPayload(unsignedTx) {
+        try {
+            const payload = JSON.parse(Buffer.from(unsignedTx, 'hex').toString());
+            return payload.signingHash;
+        }
+        catch {
+            return unsignedTx;
+        }
+    }
+    /**
+     * Attach an Ed25519 signature to the Polkadot extrinsic
+     */
+    async attachSignature(unsignedTx, signature) {
+        try {
+            const payload = JSON.parse(Buffer.from(unsignedTx, 'hex').toString());
+            const sig = signature.startsWith('0x') ? signature.slice(2) : signature;
+            const signedPayload = {
+                ...payload,
+                signature: sig,
+            };
+            return Buffer.from(JSON.stringify(signedPayload)).toString('hex');
+        }
+        catch (e) {
+            throw new errors_1.ChainError(`Failed to attach Polkadot signature: ${e.message}`, 'polkadot');
+        }
+    }
+    /**
+     * Broadcast a signed Polkadot extrinsic
+     */
+    async broadcast(signedTx) {
+        try {
+            const { ApiPromise, WsProvider } = this.polkadotApi;
+            const payload = JSON.parse(Buffer.from(signedTx, 'hex').toString());
+            const provider = new WsProvider(this.rpcUrl);
+            const api = await ApiPromise.create({ provider });
+            // Reconstruct the extrinsic with signature
+            const transfer = api.tx(payload.method);
+            // Add the Ed25519 signature (type 0x00 = Ed25519 in Polkadot)
+            transfer.addSignature(payload.fromAddress, '0x00' + payload.signature, // 0x00 prefix = Ed25519
+            {
+                nonce: payload.nonce,
+                era: api.createType('ExtrinsicEra', { current: 0, period: 64 }),
+                tip: 0,
+                blockHash: payload.blockHash,
+                genesisHash: payload.genesisHash,
+                specVersion: payload.specVersion,
+                transactionVersion: payload.transactionVersion,
+            });
+            const hash = await transfer.send();
+            await api.disconnect();
+            return hash.toHex();
+        }
+        catch (e) {
+            if (e instanceof errors_1.ChainError)
+                throw e;
+            throw new errors_1.ChainError(`Failed to broadcast Polkadot tx: ${e.message}`, 'polkadot');
+        }
+    }
+    /**
+     * Get DOT balance in planck
+     */
+    async getBalance(address) {
+        try {
+            const { ApiPromise, WsProvider } = this.polkadotApi;
+            const provider = new WsProvider(this.rpcUrl);
+            const api = await ApiPromise.create({ provider });
+            const { data: { free } } = await api.query.system.account(address);
+            await api.disconnect();
+            return free.toString();
+        }
+        catch {
+            return '0';
+        }
+    }
+}
+exports.PolkadotAdapter = PolkadotAdapter;
+function createPolkadotAdapter(rpcUrl) {
+    return new PolkadotAdapter('mainnet', rpcUrl);
+}
+function createKusamaAdapter(rpcUrl) {
+    return new PolkadotAdapter('kusama', rpcUrl);
+}
+function createPolkadotWestendAdapter(rpcUrl) {
+    return new PolkadotAdapter('westend', rpcUrl);
+}
+//# sourceMappingURL=polkadot.js.map

package/dist/chains/polkadot.js.map

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

package/dist/chains/ripple.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Ripple/XRP Chain Adapter
+ *
+ * Builds XRP Ledger transactions, attaches secp256k1 ECDSA signatures
+ * from the FROST threshold signing network, and broadcasts via XRPL API.
+ *
+ * Requires: npm install xrpl
+ */
+import { ChainAdapter, RippleTransaction } from '../core/types';
+export declare class RippleAdapter implements ChainAdapter {
+    private rpcUrl;
+    private network;
+    private xrpl;
+    constructor(network?: 'mainnet' | 'testnet' | 'devnet', rpcUrl?: string);
+    getRpcUrl(): string;
+    /**
+     * Build an unsigned XRP payment transaction.
+     *
+     * XRP uses a custom binary format. The signing payload is computed
+     * via encodeForSigning() which prepends a hash prefix. FROST signs
+     * SHA-512Half (first 32 bytes of SHA-512) of the encoded bytes.
+     */
+    buildTransaction(tx: RippleTransaction, fromAddress: string): Promise<string>;
+    getSigningPayload(unsignedTx: string): string;
+    /**
+     * Attach a secp256k1 ECDSA signature to the XRP transaction.
+     * XRP uses DER-encoded signatures in the TxnSignature field.
+     */
+    attachSignature(unsignedTx: string, signature: string): Promise<string>;
+    /**
+     * Broadcast a signed XRP transaction
+     */
+    broadcast(signedTx: string): Promise<string>;
+    /**
+     * Get XRP balance in drops
+     */
+    getBalance(address: string): Promise<string>;
+}
+export declare function createRippleAdapter(rpcUrl?: string): RippleAdapter;
+export declare function createRippleTestnetAdapter(rpcUrl?: string): RippleAdapter;
+//# sourceMappingURL=ripple.d.ts.map

package/dist/chains/ripple.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ripple.d.ts","sourceRoot":"","sources":["../../src/chains/ripple.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAUhE,qBAAa,aAAc,YAAW,YAAY;IAC9C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,IAAI,CAAM;gBAEN,OAAO,GAAE,SAAS,GAAG,SAAS,GAAG,QAAoB,EAAE,MAAM,CAAC,EAAE,MAAM;IAMlF,SAAS,IAAI,MAAM;IAInB;;;;;;OAMG;IACG,gBAAgB,CAAC,EAAE,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAoDnF,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAS7C;;;OAGG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA8B7E;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA0BlD;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAgBrD;AA8BD,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa,CAElE;AAED,wBAAgB,0BAA0B,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa,CAEzE"}

package/dist/chains/ripple.js

@@ -0,0 +1,190 @@
+"use strict";
+/**
+ * Ripple/XRP Chain Adapter
+ *
+ * Builds XRP Ledger transactions, attaches secp256k1 ECDSA signatures
+ * from the FROST threshold signing network, and broadcasts via XRPL API.
+ *
+ * Requires: npm install xrpl
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RippleAdapter = void 0;
+exports.createRippleAdapter = createRippleAdapter;
+exports.createRippleTestnetAdapter = createRippleTestnetAdapter;
+const errors_1 = require("../utils/errors");
+const optional_deps_1 = require("../utils/optional-deps");
+const DEFAULT_RPCS = {
+    'mainnet': 'wss://xrplcluster.com',
+    'testnet': 'wss://s.altnet.rippletest.net:51233',
+    'devnet': 'wss://s.devnet.rippletest.net:51233',
+};
+class RippleAdapter {
+    constructor(network = 'mainnet', rpcUrl) {
+        this.network = network;
+        this.rpcUrl = rpcUrl || DEFAULT_RPCS[network];
+        this.xrpl = (0, optional_deps_1.requireOptionalDependency)('xrpl', 'ripple');
+    }
+    getRpcUrl() {
+        return this.rpcUrl;
+    }
+    /**
+     * Build an unsigned XRP payment transaction.
+     *
+     * XRP uses a custom binary format. The signing payload is computed
+     * via encodeForSigning() which prepends a hash prefix. FROST signs
+     * SHA-512Half (first 32 bytes of SHA-512) of the encoded bytes.
+     */
+    async buildTransaction(tx, fromAddress) {
+        try {
+            const { Client, encode, encodeForSigning } = this.xrpl;
+            const client = new Client(this.rpcUrl);
+            await client.connect();
+            const payment = {
+                TransactionType: 'Payment',
+                Account: fromAddress,
+                Destination: tx.to,
+                Amount: tx.amount, // drops
+            };
+            if (tx.tag !== undefined) {
+                payment.DestinationTag = tx.tag;
+            }
+            if (tx.fee) {
+                payment.Fee = tx.fee;
+            }
+            // Autofill sequence, fee, lastLedgerSequence
+            const prepared = await client.autofill(payment);
+            await client.disconnect();
+            // Get the bytes to sign
+            const encodedForSigning = encodeForSigning(prepared);
+            // SHA-512Half: first 32 bytes of SHA-512
+            const crypto = require('crypto');
+            const fullHash = crypto.createHash('sha512')
+                .update(Buffer.from(encodedForSigning, 'hex'))
+                .digest();
+            const signingHash = fullHash.subarray(0, 32);
+            const payload = {
+                signingHash: Buffer.from(signingHash).toString('hex'),
+                prepared,
+                encodedForSigning,
+            };
+            return Buffer.from(JSON.stringify(payload)).toString('hex');
+        }
+        catch (e) {
+            if (e instanceof errors_1.ChainError)
+                throw e;
+            throw new errors_1.ChainError(`Failed to build Ripple transaction: ${e.message}`, 'ripple');
+        }
+    }
+    getSigningPayload(unsignedTx) {
+        try {
+            const payload = JSON.parse(Buffer.from(unsignedTx, 'hex').toString());
+            return payload.signingHash;
+        }
+        catch {
+            return unsignedTx;
+        }
+    }
+    /**
+     * Attach a secp256k1 ECDSA signature to the XRP transaction.
+     * XRP uses DER-encoded signatures in the TxnSignature field.
+     */
+    async attachSignature(unsignedTx, signature) {
+        try {
+            const payload = JSON.parse(Buffer.from(unsignedTx, 'hex').toString());
+            const sig = signature.startsWith('0x') ? signature.slice(2) : signature;
+            // Convert compact signature (r + s) to DER format for XRP
+            const r = Buffer.from(sig.slice(0, 64), 'hex');
+            const s = Buffer.from(sig.slice(64, 128), 'hex');
+            const derSig = encodeDER(r, s);
+            payload.prepared.TxnSignature = derSig.toString('hex').toUpperCase();
+            const { encode } = this.xrpl;
+            const signedBlob = encode(payload.prepared);
+            const signedPayload = {
+                ...payload,
+                signedBlob,
+                signature: sig,
+            };
+            return Buffer.from(JSON.stringify(signedPayload)).toString('hex');
+        }
+        catch (e) {
+            throw new errors_1.ChainError(`Failed to attach Ripple signature: ${e.message}`, 'ripple');
+        }
+    }
+    /**
+     * Broadcast a signed XRP transaction
+     */
+    async broadcast(signedTx) {
+        try {
+            const { Client } = this.xrpl;
+            const payload = JSON.parse(Buffer.from(signedTx, 'hex').toString());
+            const client = new Client(this.rpcUrl);
+            await client.connect();
+            const result = await client.submit(payload.signedBlob);
+            await client.disconnect();
+            if (result.result.engine_result !== 'tesSUCCESS' &&
+                result.result.engine_result !== 'terQUEUED') {
+                throw new Error(`Submission failed: ${result.result.engine_result_message}`);
+            }
+            return result.result.tx_json?.hash || payload.prepared.hash || '';
+        }
+        catch (e) {
+            if (e instanceof errors_1.ChainError)
+                throw e;
+            throw new errors_1.ChainError(`Failed to broadcast Ripple tx: ${e.message}`, 'ripple');
+        }
+    }
+    /**
+     * Get XRP balance in drops
+     */
+    async getBalance(address) {
+        try {
+            const { Client } = this.xrpl;
+            const client = new Client(this.rpcUrl);
+            await client.connect();
+            const info = await client.request({
+                command: 'account_info',
+                account: address,
+                ledger_index: 'validated',
+            });
+            await client.disconnect();
+            return info.result.account_data.Balance;
+        }
+        catch {
+            return '0';
+        }
+    }
+}
+exports.RippleAdapter = RippleAdapter;
+/**
+ * Encode r,s signature components into DER format for XRP
+ */
+function encodeDER(r, s) {
+    // Strip leading zeros, but ensure high bit isn't set (add 0x00 prefix if needed)
+    let rBuf = stripLeadingZeros(r);
+    let sBuf = stripLeadingZeros(s);
+    if (rBuf[0] & 0x80)
+        rBuf = Buffer.concat([Buffer.from([0x00]), rBuf]);
+    if (sBuf[0] & 0x80)
+        sBuf = Buffer.concat([Buffer.from([0x00]), sBuf]);
+    const rLen = rBuf.length;
+    const sLen = sBuf.length;
+    const totalLen = 2 + rLen + 2 + sLen;
+    return Buffer.concat([
+        Buffer.from([0x30, totalLen]), // SEQUENCE
+        Buffer.from([0x02, rLen]), rBuf, // INTEGER r
+        Buffer.from([0x02, sLen]), sBuf, // INTEGER s
+    ]);
+}
+function stripLeadingZeros(buf) {
+    let i = 0;
+    while (i < buf.length - 1 && buf[i] === 0)
+        i++;
+    return buf.subarray(i);
+}
+function createRippleAdapter(rpcUrl) {
+    return new RippleAdapter('mainnet', rpcUrl);
+}
+function createRippleTestnetAdapter(rpcUrl) {
+    return new RippleAdapter('testnet', rpcUrl);
+}
+//# sourceMappingURL=ripple.js.map

package/dist/chains/ripple.js.map

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