Get started building on World Chain and using the JSON-RPC API
Introduction
World Chain is a blockchain designed for humans, created by World to accelerate the adoption of Proof of Personhood and decentralized finance. It offers priority blockspace for verified humans, a gas allowance for casual transactions, and deep integration with the World protocol.
What is the World Chain API?
The World Chain API allows interaction with the World Chain 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.
Getting Started Instructions
1. Choose a Package Manager (npm or yarn)
Select a package manager to manage your project's dependencies. Choose between npm
and yarn
based on your preference or project requirements.
npm | yarn |
---|---|
Begin with npm by following the npm documentation. | For yarn , refer to yarn's installation guide. |
2. Set Up Your Project
Open your terminal and execute the following commands to create and initialize your project:
mkdir worldchain-api-quickstart
cd worldchain-api-quickstart
npm init --yes
mkdir worldchain-api-quickstart
cd worldchain-api-quickstart
yarn init --yes
This creates a new directory named worldchain-api-quickstart
and initializes a Node.js project within it.
3. Make Your First Request
Install Axios, a popular HTTP client, to make API requests:
npm install axios
# Or with yarn
# yarn add axios
Create an index.js
file in your project directory and paste the following code:
const axios = require('axios');
const url = `https://worldchain-mainnet.g.alchemy.com/v2/${apiKey}`;
const payload = {
jsonrpc: '2.0',
id: 1,
method: 'eth_blockNumber',
params: []
};
axios.post(url, payload)
.then(response => {
console.log('Latest Block:', response.data.result);
})
.catch(error => {
console.error(error);
});
4. Run Your Script
Execute your script to make a request to the World Chain mainnet:
node index.js
You should see the latest block information from World Chain's mainnet outputted to your console:
Latest Block: 0x...
Next Steps
Congratulations! You've made your first request to the World Chain API on the mainnet. You can now explore the various JSON-RPC methods available on World Chain and start building your dApps on this innovative platform designed for humans.