Quickstart

New to Ethereum-style chains? Read Coming from REST first — 10 minutes that explain nonce, gas, native vs token balances and why a “successful” transaction can still have failed. It also shows how much of the app needs none of this: engagement, rewards and profiles are ordinary HTTP.

1. Add YouthChain to MetaMask

Open MetaMask → Networks → Add network manually and paste:

Network Name: YouthChain
RPC URL:      https://rpc.54-237-170-237.sslip.io
Chain ID:     7717
Symbol:       YCE
Explorer:     https://explorer.54-237-170-237.sslip.io/explorer/

MetaMask doesn’t accept plain HTTP on mobile by default. For mobile testing use the built-in web wallet until HTTPS is provisioned.

2. Import a pre-funded test account

Each testnet account holds 1,000,000 YCE.

Address: 0x0ffb0d05edcc648bc5dd06e844490b98384df4a1
Key:     0x0101010101010101010101010101010101010101010101010101010101010101

Address: 0xe18d6eb6821d8b71eb34a80fe316e7a610ad4dca
Key:     0x0202020202020202020202020202020202020202020202020202020202020202

Address: 0xd1e5541380b5a082af11821291845f346dbd2570
Key:     0x0303030303030303030303030303030303030303030303030303030303030303

These keys are public and only for testnet. Never fund them on mainnet.

3. Submit your first transaction

curl
ethers.js
viem

curl -X POST https://rpc.54-237-170-237.sslip.io \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0",
    "method":"yc_sendTransaction",
    "params":[{
      "from":"0x0ffb0d05edcc648bc5dd06e844490b98384df4a1",
      "to":"0xe18d6eb6821d8b71eb34a80fe316e7a610ad4dca",
      "value":"0xde0b6b3a7640000",
      "privateKey":"0x0101010101010101010101010101010101010101010101010101010101010101"
    }],
    "id":1
  }'

import { ethers } from "ethers";

const provider = new ethers.JsonRpcProvider("https://rpc.54-237-170-237.sslip.io");
const wallet = new ethers.Wallet(
  "0x0101010101010101010101010101010101010101010101010101010101010101",
  provider
);

const tx = await wallet.sendTransaction({
  to: "0xe18d6eb6821d8b71eb34a80fe316e7a610ad4dca",
  value: ethers.parseEther("1.0"),
});
console.log("hash:", tx.hash);
await tx.wait();

import { createWalletClient, http, parseEther } from "viem";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount("0x0101...0101");
const client = createWalletClient({
  account,
  chain: { id: 7717, name: "YouthChain", nativeCurrency: { symbol: "YCE", decimals: 18, name: "YCE" }, rpcUrls: { default: { http: ["https://rpc.54-237-170-237.sslip.io"] } } },
  transport: http(),
});

const hash = await client.sendTransaction({
  to: "0xe18d6eb6821d8b71eb34a80fe316e7a610ad4dca",
  value: parseEther("1"),
});

4. Verify it was included

Query the receipt:

curl -X POST https://rpc.54-237-170-237.sslip.io \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","method":"eth_getTransactionReceipt","params":["<TX_HASH>"],"id":1}'

Or open the Block Explorer and search the hash.

5. Next steps

Submit an engagement action

Call EngagementOracle.recordAction() and watch the Engagement Score rise.

Integrate the mobile app

9 REST endpoints for register / heartbeat / engagement / profile.

Get Started

Concepts

Resources

1. Add YouthChain to MetaMask

2. Import a pre-funded test account

3. Submit your first transaction

4. Verify it was included

5. Next steps

Submit an engagement action

Integrate the mobile app

​1. Add YouthChain to MetaMask

​2. Import a pre-funded test account

​3. Submit your first transaction

​4. Verify it was included

​5. Next steps

Submit an engagement action

Integrate the mobile app

1. Add YouthChain to MetaMask

2. Import a pre-funded test account

3. Submit your first transaction

4. Verify it was included

5. Next steps