Soneium is an innovative Ethereum Layer 2 blockchain platform developed by Sony Block Solutions Labs. It aims to integrate Web3 technologies into everyday life, creating an inclusive digital world where everyone can be a creator and innovator. Soneium offers a robust infrastructure for developers to build impactful decentralized applications (dApps) and digital assets, while providing users with a secure and user-friendly environment for interacting with blockchain technology.

The Soneium API allows interaction with the Soneium network through a set of JSON-RPC methods. Its design is familiar to developers who have worked with Ethereum’s JSON-RPC APIs, making it intuitive and straightforward to use.

Send Your First Request on Alchemy

Let’s use the viem package to create a Soneium client connected to Alchemy and fetch the latest block number!

npm install --save viem

Create Client Connected to Alchemy

1
import { createPublicClient, http } from "viem"; 
2
import { soneium } from "viem/chains";
3
4
const client = createPublicClient({
5
  chain: soneium,
6
  transport: http("https://soneium-mainnet.g.alchemy.com/v2/YOUR_ALCHEMY_API_KEY"),
7
});

Now that you’ve created a client connected to Alchemy, you can continue with some basics:

Get Latest Block Number

1
const blockNumber = await client.getBlockNumber();
2
console.log("Current block number:", blockNumber);

Get an Address Balance

1
const balance = await client.getBalance({ address: "0xab5801a7d398351b8be11c439e05c5b3259aec9b" });
2
console.log("Balance (ETH):", Number(balance) / 1e18);

Read Block Data

1
const block = await client.getBlock({
2
  blockNumber: blockNumber, // from previous example
3
});
4
console.log(block);

Fetch a Transaction by Hash

1
const tx = await client.getTransaction({ hash: "0xYOUR_TX_HASH" });
2
console.log(tx);

Fetch Transaction Receipt

1
const receipt = await client.getTransactionReceipt({
2
  hash: "0xYOUR_TX_HASH"
3
});
4
console.log(receipt);

Soneium APIs

For the full list of Soneium APIs, see the Soneium API Endpoints.