Ethereum Multicurrency Wallet API Documentation

Introduction

This is the open source API documentation for a multi-currency wallet system built using Ethereum smart contracts. The API allows developers to generate and manage multiple coins, create wallets, send/receive funds, and perform various transactions.

API Overview

The following endpoints are available in this API:

• Generate Address: Generates a new address for a specific coin.

• Get Address: Get the address associated with a specific wallet.

• Send funds: sending funds from one address to another.

• Receiving funds: receiving funds from the address.

• Wallets

  : list of all wallets in the system, including their addresses and balances.

Generate Address

The generateAddress' endpoint generates a new address for the specified currency. The address is generated using a combination of the Ethereum public key and a hash value based on the amount to be transferred.

Endpoint:/api/v1/addresses/generate

• Request Body:{ «currency»: » Dogecoin» }

• Response: {«address»: «0x1234567890abcdef»}

ThegetAddress’ endpoint retrieves the address associated with a specific wallet.

Endpoint: /api/v1/wallets/{walletId}/addresses

• Request Body: { "walletId": " wallet-12345" }

• Response: {"address": "0xabcdef0123456789"}

Send Funds

The «sendFunds» endpoint sends funds from one address to another. The amount of the transfer is indicated in the body of the request.

Endpoint: /api/v1/wallets/{walletId}/addresses/{fromAddress}/transactions/{toAddress}

• Request Body: { "amount": 10, "fromAddress": "0xabcdef0123456789", "toAddress": "0x1234567890abcdef" }

• Response: {"transactionHash": "tx-1234567890abcdef"}

Get Funds

The «receiveFunds» endpoint receives funds from the address. The amount to be received is indicated in the text of the request.

Endpoint: /api/v1/wallets/{walletId}/addresses/{fromAddress}/transactions/

• Request Body: { "amount": 10, "fromAddress": "0xabcdef0123456789", "toAddress": "0x1234567890abcdef" }

• Response: {"transactionHash": "tx-1234567890abcdef"}

Wallets

The «wallets» endpoint contains a list of all wallets in the system, including their addresses and balances.

Endpoint: /api/v1/wallets

• Request Body: {} (no parameters)

• Response: [ { "address": "0x1234567890abcdef", "balance": 100 } ]

Examples of use cases

Here’s an example of using the generateAddress' endpoint:

const axios = require('axios');

const EthereumApi = require('./EthereumApi');


const api = new EthereumApi();


async function main() {

  const generateAddressResponse = await api.generateAddress({

    currency: "Dogecoin",

  });


  console.log(generateAddressResponse.address);


  // Use the generated address to send funds

  const sendFundsResponse = await api.sendFunds({

    quantity: 10,

    fromAddress: generateAddressResponse.address,

    toAddress: "0x1234567890abcdef",

  });

}


main();

• POST /api/v1/addresses/generate: Generate a new address for the specified currency.

• GET /api/v1/wallets/{walletId}/addresses: Get the address associated with a specific wallet.

• POST /api/v1/wallets/{walletId}/addresses/{fromAddress}/transactions/{toAddress}`: sending funds from one address to another.