Cómo construir un servidor de retransmisión de transacciones

Asegúrate de tener instalado pnpm (u otro gestor de paquetes de Node) con el siguiente comando:

curl -fsSL https://get.pnpm.io/install.sh | sh -

Luego, clone el siguiente código de plantilla de express

Una vez que el código esté en su máquina local, ejecute su servidor y cliente con el siguiente comando:

pnpm run start

Dentro del código hay una ruta llamada /mint que puede llamarse desde la CLI para pruebas.

Pruebe con este ejemplo de solicitud curl:

curl -X POST http://localhost:3000/mint -d '{"tokenID": 0, "address": "0x"}'

Debería ver la siguiente salida:

{"txHash":"0x"}

Primero, siga esta guía para aprender cómo registrarse en Sequence Builder y cómo crear un proyecto.

Luego, para usar la Transactions API, deberá actualizar su facturación a Developer, lo cual puede hacer siguiendo esta guía.

Finalmente, se requiere una Public Access Key para la Transactions API, que puede obtener siguiendo esta guía.

Por último, actualice el archivo .env.example a .env con lo siguiente:

CHAIN_HANDLE='<CHAIN_HANDLE>' # e.g. `mainnet`, `xr-sepolia`, etc.

PROJECT_ACCESS_KEY='<PUBlIC_ACCESS_KEY>'

Siga esta guía para desplegar un contrato de coleccionables.

Finalmente, actualice el archivo .env con su contrato de coleccionables desplegado:

...

COLLECTIBLE_CONTRACT_ADDRESS="<ADDRESS>"

​

Construya un relayer patrocinado con la Transactions API

Primero, usando el código de plantilla proporcionado en el paso #1, necesitaremos agregar algunos paquetes

import { Session } from '@0xsequence/auth'

import { findSupportedNetwork, NetworkConfig } from '@0xsequence/network'

Luego, su servidor necesitará una wallet EOA que pueda firmar mensajes. Será la propietaria de su wallet Sequence del lado del servidor, la cual se usará para enviar transacciones.

Para implementar la función callContract, incluya el siguiente código que utiliza un único firmante para retransmitir transacciones:

const callContract = async (address: string, tokenID: number): Promise<ethers.providers.TransactionResponse> => {

	

	const chainConfig: NetworkConfig = findSupportedNetwork(process.env.CHAIN_HANDLE!)!

	const provider = new ethers.providers.StaticJsonRpcProvider({

		url: chainConfig.rpcUrl

	})



	const walletEOA = new ethers.Wallet(process.env.PKEY!, provider);

	const relayerUrl = `https://${chainConfig.name}-relayer.sequence.app`



	// Create a single signer sequence wallet session

	const session = await Session.singleSigner({

		signer: walletEOA,

		projectAccessKey: process.env.PROJECT_ACCESS_KEY!

	})



	const signer = session.account.getSigner(chainConfig.chainId)

	

	// Standard interface for ERC1155 contract deployed via Sequence Builder

	const collectibleInterface = new ethers.Interface([

		'function mint(address to, uint256 tokenId, uint256 amount, bytes data)'

	])

		

	const data = collectibleInterface.encodeFunctionData(

		'mint', [`${address}`, `${tokenID}`, "1", "0x00"]

	)



	const txn = {

		to: process.env.COLLECTIBLE_CONTRACT_ADDRESS, 

		data: data

	}



	try {

		return await signer.sendTransaction(txn)

	} catch (err) {

		console.error(`ERROR: ${err}`)

		throw err

	}

}

Por último, actualice el archivo .env con una clave privada para una wallet que puede generarse desde esta aplicación (solo para fines de demostración). Para producción, recomendamos generar claves privadas de forma segura y local en su computadora usando este script de ejemplo.

Luego, actualice la variable PKEY con la clave:

...

PKEY='<WALLET_PRIVATE_KEY>'

​

Otorgar el rol MINTER_ROLE a la dirección de la wallet relayer

Debe actualizar el acceso por roles del contrato en el Builder para que solo reciba solicitudes desde la dirección de la wallet minter.

Puede hacer esto en Sequence Builder otorgando el minter permission a su Sequence Wallet Transactions API Address.

Para hacerlo, abra su proyecto, navegue a la página de Contracts, seleccione sus Linked contracts y, en la pestaña Write Contract, expanda el método grantRole.

Complete con los siguientes datos:

bytes32 role: 0x9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a6

address account: <Generated Sequence Transactions API Wallet Address>

Donde el valor de role ingresado es el resultado de keccak256("MINTER_ROLE") en solidity o ethers.solidityPackedKeccak256(ethers.toUtf8Bytes("MINTER_ROLE")) en javascript

Esto hace que solo su dirección específica pueda mintear desde el contrato; de lo contrario, dará error.

Complete la actualización del rol haciendo clic en write y firme la transacción patrocinada.

Su aplicación ya está lista para que envíe una transacción de prueba desde el frontend del cliente iniciando sesión en su wallet y haciendo clic en mintear.

¡Pruébelo!