Add utxosToAccount rpc

packages/jellyfish-api-core/__tests__/category/account.test.ts

@@ -479,4 +479,44 @@ describe('masternode', () => {
       })
     })
   })
+
+  describe('utxosToAccount', () => {
+    let address1: string
+    let address2: string
+
+    beforeAll(async () => {
+      address1 = await container.call('getnewaddress')
+      address2 = await container.call('getnewaddress')
+    })
+
+    it('should utxosToAccount', async () => {
+      const payload: any = {}
+      payload[address1] = '5@DFI'
+      payload[address2] = '5@DFI'
+
+      const data = await client.account.utxosToAccount(payload)
+
+      expect(typeof data).toBe('string')
+      expect(data.length).toBe(64)
+    })
+
+    it('should utxosToAccount with utxos', async () => {
+      const payload: any = {}
+      payload[address1] = '5@DFI'
+      payload[address2] = '5@DFI'
+
+      const utxos = await container.call('listunspent')
+      const inputs = utxos.map((utxo: { txid: string, vout: number }) => {
+        return {
+          txid: utxo.txid,
+          vout: utxo.vout
+        }
+      })
+
+      const data = await client.account.utxosToAccount(payload, inputs)
+
+      expect(typeof data).toBe('string')
+      expect(data.length).toBe(64)
+    })
+  })
 })

packages/jellyfish-api-core/src/category/account.ts

@@ -220,6 +220,20 @@ export class Account {
   ): Promise<AccountHistory[]> {
     return await this.client.call('listaccounthistory', [owner, options], 'number')
   }
+
+  /**
+   * Creates (and submits to local node and network) a transfer transaction from the wallet UTXOs to specfied account.
+   * The second optional argument (may be empty array) is an array of specific UTXOs to spend.
+   *
+   * @param {any} [payload]
+   * @param {UtxosToAccountUTXO[]} [options=[]]
+   * @param {string} [options.txid]
+   * @param {number} [options.vout]
+   * @return {Promise<string>}
+   */
+  async utxosToAccount (payload: any, options: UtxosToAccountUTXO[] = []): Promise<string> {
+    return await this.client.call('utxostoaccount', [payload, options], 'number')
+  }
 }
 
 export interface AccountPagination {
@@ -277,3 +291,8 @@ export interface AccountHistoryOptions {
   txtype?: string
   limit?: number
 }
+
+export interface UtxosToAccountUTXO {
+  txid: string
+  vout: number
+}

website/docs/jellyfish/api/account.md

@@ -142,3 +142,19 @@ interface AccountHistoryOptions {
   limit?: number
 }
 ```
+
+## utxosToAccount
+
+Creates (and submits to local node and network) a transfer transaction from the wallet UTXOs to specfied account.
+The second optional argument (may be empty array) is an array of specific UTXOs to spend.
+
+```ts title="client.account.utxosToAccount()"
+interface account {
+  utxosToAccount (payload: any, options: UtxosToAccountUTXO[] = []): Promise<string>
+}
+
+interface UtxosToAccountUTXO {
+  txid: string
+  vout: number
+}
+```