Skip to main content
POST
tempo_fundAddress
curl --request POST \
  --url https://rpc.testnet.tempo.xyz/ \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "method": "tempo_fundAddress",
  "params": [
    "0xc2F695613de0885dA3bdd18E8c317B9fAf7d4eba"
  ],
  "id": 1
}
'
{
  "jsonrpc": "<string>",
  "id": 123,
  "result": [
    "<string>"
  ]
}
Tempo API method that funds an address with testnet stablecoins. This is Tempo’s faucet mechanism — instead of a web UI, tokens are distributed via this RPC method.
Testnet only: This method is only available on the Tempo testnet. It will not work on mainnet.

​
Parameters

  • address — the address to fund with testnet stablecoins

​
Response

  • result — an array of transaction hashes, one for each funded token

​
Tokens funded

This method sends the following testnet stablecoins to your address:
TokenAddress
pathUSD0x20c0000000000000000000000000000000000000
AlphaUSD0x20c0000000000000000000000000000000000001
BetaUSD0x20c0000000000000000000000000000000000002
ThetaUSD0x20c0000000000000000000000000000000000003

​
tempo_fundAddress code examples

const ethers = require('ethers');
const NODE_URL = "CHAINSTACK_NODE_URL";
const provider = new ethers.JsonRpcProvider(NODE_URL);

const fundAddress = async (address) => {
    const result = await provider.send("tempo_fundAddress", [address]);
    console.log("Funding transaction hashes:");
    result.forEach((hash, i) => {
      console.log(`  Token ${i + 1}: ${hash}`);
    });
  };

fundAddress("0xc2F695613de0885dA3bdd18E8c317B9fAf7d4eba");

​
Example response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    "0x54340f261371117e7d5d39d241a48c595c0626871c38179248262b3a425dd71d",
    "0x2d8840c6df9fdfe7cbcdca4a4d5b97cb1a520580e2a5be074eb018e2868808f6",
    "0x5ec61f424fd34aa3faa57eb29204f95de7160bc35f892e358aa23c61e3640fe8",
    "0xc946437b2fe84d0666bf158e0ed3b8d56f285c440b291b89ea1d2a3487319396"
  ]
}

Body

application/json
​
jsonrpc
string
default:2.0
​
method
string
default:tempo_fundAddress
​
params
any[]

The address to fund with testnet tokens

​
id
integer
default:1

Response

200 - application/json

Array of transaction hashes for each funded token

​
jsonrpc
string
​
id
integer
​
result
string[]

Array of transaction hashes (one per funded token)