@omnity/ree-client-ts-sdk 0.3.2 → 0.3.4

package/README.md

@@ -75,20 +75,21 @@ const transaction = await client.createTransaction({
 // Add a single intention (e.g., swap BTC for runes)
 transaction.addIntention({
   poolAddress: "bc1p...",
+  poolUtxos: [],
   inputCoins: [
     {
-      coin: { 
-        id: "0:0", 
-        value: BigInt(100000) 
+      coin: {
+        id: "0:0",
+        value: BigInt(100000),
       }, // Send 0.001 BTC,
       from: paymentAddress,
     },
   ],
   outputCoins: [
     {
-      coin: { 
-        id: "840000:3", 
-        value: BigInt(1000) 
+      coin: {
+        id: "840000:3",
+        value: BigInt(1000),
       }, // Receive 1000 runes,
       to: address,
     },
@@ -116,12 +117,13 @@ const transaction = await client.createTransaction({
 // Intention 1: Deposit BTC to Pool 1
 transaction.addIntention({
   poolAddress: "bc1p...pool1",
+  poolUtxos: [],
   inputCoins: [
     {
       // Deposit 0.0005 BTC
-      coin: { 
-        id: "0:0", 
-        value: BigInt(50000) 
+      coin: {
+        id: "0:0",
+        value: BigInt(50000),
       },
       from: paymentAddress,
     },
@@ -134,12 +136,13 @@ transaction.addIntention({
 // Intention 2: Swap runes between pools
 transaction.addIntention({
   poolAddress: "bc1q...pool2",
+  poolUtxos: [],
   inputCoins: [
     {
       // Send 500 of rune A,
-      coin: { 
-        id: "840000:3", 
-        value: BigInt(500) 
+      coin: {
+        id: "840000:3",
+        value: BigInt(500),
       },
       from: address,
     },
@@ -147,9 +150,9 @@ transaction.addIntention({
   outputCoins: [
     {
       // Receive 250 of rune B,
-      coin: { 
-        id: "840000:5", 
-        value: BigInt(250) 
+      coin: {
+        id: "840000:5",
+        value: BigInt(250),
       },
       to: address,
     },
@@ -195,16 +198,17 @@ function WalletComponent() {
     // Add multiple intentions
     tx.addIntention({
       poolAddress: "pool1",
+      poolUtxos: [],
       inputCoins: [{
-        coin: { 
-          id: "0:0", 
-          value: BigInt(100000) 
+        coin: {
+          id: "0:0",
+          value: BigInt(100000)
         },
         from: paymentAddress
       }],
       outputCoins: [
-        coint: { 
-          id: "840000:3", 
+        coint: {
+          id: "840000:3",
           value: BigInt(1000)
         },
         to: address
@@ -215,17 +219,18 @@ function WalletComponent() {
 
     tx.addIntention({
       poolAddress: "pool2",
+      poolUtxos: [],
       inputCoins: [{
-        coin: { 
-          id: "840000:3", 
-          value: BigInt(500) 
+        coin: {
+          id: "840000:3",
+          value: BigInt(500)
         },
         from: address
       }],
       outputCoins: [{
-        coin: { 
-          id: "0:0", 
-          value: BigInt(50000) 
+        coin: {
+          id: "0:0",
+          value: BigInt(50000)
         },
         to: paymentAddress
       }],
@@ -282,13 +287,16 @@ function MyComponent({ children }) {
 
     tx.addIntention({
       poolAddress: "bc1q...",
-      inputCoins: [{
-        coin: { 
-          id: "0:0", 
-          value: depositBtcAmount 
+      poolUtxos: [],
+      inputCoins: [
+        {
+          coin: {
+            id: "0:0",
+            value: depositBtcAmount,
+          },
+          from: paymentAddress,
         },
-        from: paymentAddress
-      }],
+      ],
       outputCoins: [],
       action: "deposit",
       nonce: depositOffer.nonce,
@@ -377,20 +385,28 @@ Transaction builder for Bitcoin and Rune transactions with multi-intention suppo
 
 ```typescript
 interface Intention {
-  poolAddress: string; // Target pool address
-  inputCoins: InputCoin[]; // Coins being sent to the pool
-  outputCoins: InputCoin[]; // Coins expected from the pool
-  action: string; // Action type (swap, deposit, withdraw, etc.)
-  actionParams?: string; // Optional action parameters
-  nonce: bigint; // Unique nonce for the intention
+  // Target pool address
+  poolAddress: string;
+  // the UTXOs obtained through the pool’s pre methods
+  poolUtxos?: [];
+  // Coins being sent to the pool
+  inputCoins: InputCoin[];
+  // Coins expected from the pool
+  outputCoins: InputCoin[];
+  // Action type (swap, deposit, withdraw, etc.)
+  action: string;
+  // Optional action parameters
+  actionParams?: string;
+  // Unique nonce for the intention
+  nonce: bigint;
 }
 
 type CoinBalance = {
   id: string; // Coin ID ("0:0" for BTC, "840000:3" for runes)
   value: bigint; // Amount in smallest unit
-}
+};
 
- type InputCoin = {
+type InputCoin = {
   coin: CoinBalance;
   from: string;
 };
@@ -399,7 +415,6 @@ type OutputCoin = {
   coin: CoinBalance;
   to: string;
 };
-
 ```
 
 ### Multi-Intention Transaction Benefits
@@ -559,4 +574,3 @@ enum Network {
   Testnet = "testnet",
 }
 ```
-

package/dist/index.d.ts

@@ -47,10 +47,22 @@ export declare type Config = {
     exchangeCanisterId: string;
 };
 
+declare function formatPoolUtxo(poolAddress: string, input: {
+    coins: [{
+        id: string;
+        value: bigint;
+    }];
+    sats: bigint;
+    txid: string;
+    vout: number;
+}, network: Network): Utxo;
+
 declare function getAddressType(address: string): AddressType;
 
 declare function getScriptByAddress(address: string, network?: Network): Uint8Array<ArrayBufferLike>;
 
+declare function getUtxoProof(utxos: Utxo[], network: Network): Promise<number[] | null>;
+
 declare function hexToBytes(hex: string): Uint8Array;
 
 export declare type InputCoin = {
@@ -64,6 +76,7 @@ export declare type Intention = {
     action: string;
     actionParams?: string;
     poolAddress: string;
+    poolUtxos?: Utxo[];
     nonce: bigint;
 };
 
@@ -593,7 +606,9 @@ export declare namespace utils {
         bytesToHex,
         toBitcoinNetwork,
         getScriptByAddress,
-        getAddressType
+        getAddressType,
+        formatPoolUtxo,
+        getUtxoProof
     }
 }