Submit a transaction

Three ways to get a tx onto the chain — pick the one that fits your stack.

Path 1 — RPC shortcut (testnet)

yc_sendTransaction signs with a provided private key server-side. Useful for scripts and demos. Not for production.

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":"0x0ffb...",
      "to":"0xe18d...",
      "value":"0xde0b6b3a7640000",
      "privateKey":"0x0101..."
    }],
    "id":1
  }'

Path 2 — Client-signed raw tx

Sign locally, submit via eth_sendRawTransaction.

import { ethers } from "ethers";
const provider = new ethers.JsonRpcProvider("https://rpc.54-237-170-237.sslip.io");
const wallet = new ethers.Wallet(PRIVKEY, provider);

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

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

const account = privateKeyToAccount(PRIVKEY);
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: RECIPIENT,
  value: parseEther("1"),
});

Path 3 — Contract call (Solidity ABI)

Call a deployed contract — here, record an engagement action.

import { ethers } from "ethers";
import abi from "./EngagementOracle.abi.json";

const oracle = new ethers.Contract(
  "0xb7646654d1fd946e8a8bc32b5786a571be5925f2",
  abi,
  wallet
);

const targetId = ethers.id("post_xyz123"); // keccak256
const tx = await oracle.recordAction(
  wallet.address,
  1,                         // ActionType.Like
  ethers.parseEther("0.2"),  // weight scaled 1e18
  targetId
);
await tx.wait();

Confirming the tx

Regardless of path, the follow-up is the same:

const receipt = await provider.getTransactionReceipt(tx.hash);
if (!receipt) {
  // still pending — try again in ~5s
}
if (receipt.status === 0) {
  // reverted
}

Block time is ~5s, so poll on that cadence: most transactions confirm on the first or second poll. Do not poll every second — you will just burn requests waiting for a round that has not happened yet.

​Path 1 — RPC shortcut (testnet)

​Path 2 — Client-signed raw tx

​Path 3 — Contract call (Solidity ABI)

​Confirming the tx

Path 1 — RPC shortcut (testnet)

Path 2 — Client-signed raw tx

Path 3 — Contract call (Solidity ABI)

Confirming the tx