← Web3 / web3 / how-to

Использование шлюза Ethereum

После того как у вас появится шлюз Ethereum, то есть вы создать новый шлюз с target Ethereum : вы можете взаимодействовать с различные сети Ethereum указав правильный JSON объект для вашего запроса.

Чтение из сети

Шлюз Cloudflare Ethereum Gateway принимает HTTP-запросы, тело которых представляет собой JSON-тело нужного вам запроса. Например, если вы хотите прочитать блок под номером 0x2244, тогда ваш JSON-объект будет иметь такой вид:

{
	"jsonrpc": "2.0",
	"method": "eth_getBlockByNumber",
	"params": ["0x2244", true],
	"id": 1
}

Каждый blob использует допустимый method параметр. params массив здесь содержит номер блока, который нужно найти, и логическое значение, указывающее, следует ли показывать каждую отдельную транзакцию в блоке полностью (true) или в виде заглушек (false).

Чтобы отправить этот запрос на ваш настраиваемый шлюз Ethereum, вы можете использовать команду cURL:

curl https://web3-trial.cloudflare-eth.com/v1/mainnet -H 'Content-Type: application/json' --data '{"jsonrpc":"2.0","method":"eth_getBlockByNumber","params":["0x2244", true],"id":1}'

Тот же запрос можно также написать с помощью JS Fetch API:

await fetch(
	new Request("https://web3-trial.cloudflare-eth.com/v1/mainnet", {
		method: "POST",
		body: JSON.stringify({
			jsonrpc: "2.0",
			method: "eth_getBlockByNumber",
			params: ["0x2244", true],
			id: 1,
		}),
		headers: {
			"Content-Type": "application/json",
		},
	}),
).then((resp) => {
	return resp.json();
});

В обоих случаях ответ будет представлять собой JSON-объект следующего вида:

{
	"jsonrpc": "2.0",
	"id": 1,
	"result": {
		"difficulty": "0x746ef15b66",
		"extraData": "0x476574682f76312e302e302f6c696e75782f676f312e342e32",
		"gasLimit": "0x1388",
		"gasUsed": "0x0",
		"hash": "0xd6bb42034740c5d728e774e43a01f26222e0fcc279c504ca5963dc34fe70f392",
		"logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
		"miner": "0xf927a40c8b7f6e07c5af7fa2155b4864a4112b13",
		"mixHash": "0x975da446e302e6da6cedb3fbaa763c3c203ae88d6fab4924e2a3d34a568c4361",
		"nonce": "0x88a7f12f49151c83",
		"number": "0x2244",
		"parentHash": "0x067fd84ecdbc7491bf5ec7d5d4ead361b1f590eec74797a7f90b4a7d7004a48d",
		"receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
		"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
		"size": "0x21b",
		"stateRoot": "0x828dade2067283e370993ec6a1bda0e65c1310e404a6d5bbb030b596eb80017c",
		"timestamp": "0x55bb040f",
		"totalDifficulty": "0x5c328da43525d",
		"transactions": [],
		"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
		"uncles": []
	}
}

Запись в сеть

На данный момент Ethereum Gateway позволяет отправлять данные в сеть с помощью eth_sendRawTransaction RPC метод. Он создает новую транзакцию вызова сообщения либо транзакцию создания контракта для подписанных транзакций. Транзакции подписываются секретным ключом, соответствующим вашему собственному Кошелек Ethereum ↗.

После того как у вас настроен кошелёк и есть способ подписывать собственные транзакции, вы можете отправить эту транзакцию в сеть Ethereum через Cloudflare Ethereum Gateway. Подписанные транзакции представлены в виде шестнадцатеричных строк такого вида:

"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"

После этого вы можете использовать свой настраиваемый шлюз чтобы отправить транзакцию в сеть с помощью команды cURL:

curl https://web3-trial.cloudflare-eth.com/v1/mainnet -H 'Content-Type: application/json' --data '{"jsonrpc":"2.0","method":"eth_sendRawTransaction","params":["0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"],"id":1}'

Также можно использовать запрос JS Fetch API:

await fetch(
	new Request("https://web3-trial.cloudflare-eth.com/v1/mainnet", {
		method: "POST",
		body: JSON.stringify({
			jsonrpc: "2.0",
			method: "eth_sendRawTransaction",
			params: [
				"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",
			],
			id: 1,
		}),
		headers: {
			"Content-Type": "application/json",
		},
	}),
).then((resp) => {
	return resp.json();
});

(Приведенная выше команда фактически не сработает: вам нужно указать собственную подписанную транзакцию.)