Add accountToAccount RPC

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

@@ -3,6 +3,7 @@ import { ContainerAdapterClient } from '../container_adapter_client'
 import waitForExpect from 'wait-for-expect'
 import BigNumber from 'bignumber.js'
 import { UtxosToAccountPayload } from '../../src/category/account'
+import { RpcApiError } from '../../src'
 
 describe('masternode', () => {
   const container = new MasterNodeRegTestContainer()
@@ -44,6 +45,10 @@ describe('masternode', () => {
     await container.call('createtoken', [metadata])
     await container.generate(1)
 
+    const payload: { [key: string]: string } = {}
+    payload[address] = '100@0'
+    await container.call('utxostoaccount', [payload])
+
     await container.call('minttokens', [`${amount.toString()}@${symbol}`])
     await container.generate(1)
   }
@@ -515,5 +520,92 @@ describe('masternode', () => {
       expect(typeof data).toBe('string')
       expect(data.length).toBe(64)
     })
+
+    it('should not utxosToAccount with utxos for DFI coin if does not own the recipient address', async () => {
+      const payload: UtxosToAccountPayload = {}
+      // NOTE(jingyi2811): Only support sending utxos to DFI account.
+      payload['2Mywjs9zEU4NtLknXQJZgozaxMvPn2Bb3qz'] = '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 promise = client.account.utxosToAccount(payload, inputs)
+
+      await expect(promise).rejects.toThrow(RpcApiError)
+      await expect(promise).rejects.toThrow('The address (2Mywjs9zEU4NtLknXQJZgozaxMvPn2Bb3qz) is not your own address')
+    })
+  })
+
+  describe('accountToAccount', () => {
+    it('should accountToAccount', async () => {
+      const from = await container.getNewAddress()
+      await createToken(from, 'DABC', 5)
+      await createToken(from, 'DDEF', 5)
+
+      const payload: UtxosToAccountPayload = {}
+      payload[await container.getNewAddress()] = '5@DFI'
+      payload[await container.getNewAddress()] = '5@DABC'
+      payload[await container.getNewAddress()] = '5@DDEF'
+
+      const data = await client.account.accountToAccount(from, payload)
+
+      expect(typeof data).toBe('string')
+      expect(data.length).toBe(64)
+    })
+
+    it('should accountToAccount with utxos', async () => {
+      const from = await container.getNewAddress()
+      await createToken(from, 'DGHI', 5)
+      await createToken(from, 'DJKL', 5)
+
+      const { txid } = await container.fundAddress(from, 10)
+
+      const payload: UtxosToAccountPayload = {}
+      payload[await container.getNewAddress()] = '5@DFI'
+      payload[await container.getNewAddress()] = '5@DGHI'
+      payload[await container.getNewAddress()] = '5@DJKL'
+
+      const utxos = await container.call('listunspent')
+
+      const inputs = utxos.filter((utxo: any) => utxo.txid === txid).map((utxo: any) => {
+        return {
+          txid: utxo.txid,
+          vout: utxo.vout
+        }
+      })
+
+      const data = await client.account.accountToAccount(from, payload, inputs)
+
+      expect(typeof data).toBe('string')
+      expect(data.length).toBe(64)
+    })
+
+    it('should not accountToAccount with utxos for DFI coin if does not own the recipient address', async () => {
+      const from = await container.getNewAddress()
+
+      const payload: UtxosToAccountPayload = {}
+      payload['2Mywjs9zEU4NtLknXQJZgozaxMvPn2Bb3qz'] = '5@DFI'
+
+      const { txid } = await container.fundAddress(from, 10)
+
+      const utxos = await container.call('listunspent')
+
+      const inputs = utxos.filter((utxo: any) => utxo.txid === txid).map((utxo: any) => {
+        return {
+          txid: utxo.txid,
+          vout: utxo.vout
+        }
+      })
+
+      const promise = client.account.accountToAccount(from, payload, inputs)
+
+      await expect(promise).rejects.toThrow(RpcApiError)
+      await expect(promise).rejects.toThrow('The address (2Mywjs9zEU4NtLknXQJZgozaxMvPn2Bb3qz) is not your own address')
+    })
   })
 })

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

@@ -235,6 +235,22 @@ export class Account {
   async utxosToAccount (payload: UtxosToAccountPayload, utxos: UtxosToAccountUTXO[] = []): Promise<string> {
     return await this.client.call('utxostoaccount', [payload, utxos], 'number')
   }
+
+  /**
+   * Creates and submits to a local node and transfer transaction from the specified account to the specfied accounts.
+   * Optionally, specific UTXOs to spend to create that transaction.
+   *
+   * @param {string} from
+   * @param {AccountToAccountPayload} payload
+   * @param {string} payload[address]
+   * @param {AccountToAccountUTXO[]} [utxos=[]]
+   * @param {string} [utxos.txid]
+   * @param {number} [utxos.vout]
+   * @return {Promise<string>}
+   */
+  async accountToAccount (from: string, payload: AccountToAccountPayload, utxos: AccountToAccountUTXO[] = []): Promise<string> {
+    return await this.client.call('accounttoaccount', [from, payload, utxos], 'number')
+  }
 }
 
 export interface AccountPagination {
@@ -301,3 +317,12 @@ export interface UtxosToAccountUTXO {
   txid: string
   vout: number
 }
+
+export interface AccountToAccountPayload {
+  [key: string]: string
+}
+
+export interface AccountToAccountUTXO {
+  txid: string
+  vout: number
+}

website/docs/jellyfish/api/account.md

@@ -162,3 +162,23 @@ interface UtxosToAccountUTXO {
   vout: number
 }
 ```
+
+## accountToAccount
+
+Creates and submits to a local node and transfer transaction from the specified account to the specfied accounts.
+Optionally, specific UTXOs to spend to create that transaction.
+
+```ts title="client.account.accountToAccount()"
+interface account {
+  accountToAccount (from: string, payload: AccountToAccountPayload, utxos: AccountToAccountUTXO[] = []): Promise<string> {
+}
+
+interface AccountToAccountPayload {
+  [key: string]: string;
+}
+
+interface AccountToAccountUTXO {
+  txid: string
+  vout: number
+}
+```