Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.sequence.xyz/llms.txt

Use this file to discover all available pages before exploring further.

La mayoría de sus jugadores no tendrán criptomonedas en sus wallets. Ingresar fondos a criptomonedas usando métodos tradicionales puede ser complicado para los jugadores y puede ser demasiado estresante para usuarios con menos experiencia técnica. En cualquier caso, minimizar la fricción en los pagos siempre ha sido un requisito muy importante para una estrategia de monetización efectiva. El método más sencillo para realizar microtransacciones para la mayoría de los usuarios en móviles será con el método de compra dentro de la app al que ya están acostumbrados: IAP a través de la App Store de iOS y Google Play Store de Android. Esto es especialmente cierto si está usando Embedded Wallets y construyendo juegos donde la blockchain es invisible. Esta guía explicará cómo actualizamos Jelly Forest, nuestro juego de demostración de Embedded Wallet hecho con Unity, para agregar una compra IAP que mintear un divertido sombrero de hot dog para su Jelly.

​
Desplegar un Smart Contract

El primer paso, si aún no lo ha hecho, es desplegar un smart contract que definirá y representará los NFT que desea vender a sus jugadores y mostrar en su juego. Una vez que haya desplegado su smart contract, no olvide agregar la dirección de su contrato como una Sponsored Address en la página de “Gas Sponsoring” dentro del Builder Console. Así, las comisiones de gas de sus usuarios serán patrocinadas automáticamente usando sus créditos de cómputo al interactuar con los smart contracts de su juego.

​
Desplegar un Remote Minter

Por defecto, los contratos ERC1155/721 desplegados a través del Builder Console requieren que quienes llamen tengan los permisos apropiados para mintear un token. Aunque esto pueda parecer una molestia a primera vista, ¡es algo bueno! Sin esto, cualquiera podría llamar al método de minteo en su contrato y darse a sí mismo ítems infinitos en el juego. Querrá implementar un servidor con un wallet de Sequence (u otro) y darle permisos de minteo en el Builder Console.

​
Cómo lo hicimos en Jelly Forest

En Jelly Forest, todas las monedas que recolecta durante el juego se mintean como tokens ERC1155. Así es como lo hicimos:
  1. Regístrese en Cloudflare – aquí es donde alojamos el código del servicio de minteo; si lo prefiere, puede usar cualquier otro método
  2. Abra la terminal u otra línea de comandos
  3. git clone https://github.com/0xsequence-demos/cloudflare-worker-sequence-relayer.git luego cd cloudflare-worker-sequence-relayer
  4. git checkout permissionedMinter
  5. pnpm install – para instalar las dependencias
  6. Instale wrangler
pnpm install wrangler --save-dev
alias wrangler='./node_modules/.bin/wrangler'
inicie sesión 
wrangler login
  1. Abra wrangler.toml
    1. Asigne un nombre a su servidor cambiando el valor de name
    2. Cree un nuevo wallet EOA y exporte la clave privada. Cualquier wallet EOA funciona. Puede usar Metamask para configurar un wallet fácilmente y exportar la clave privada. ¡Tenga mucho cuidado con la clave privada y no la guarde en texto plano en su computadora ni la suba a control de versiones! Establezca esto en PKEY
    3. Establezca el CONTRACT_ADDRESS
    4. Establezca el PROJECT_ACCESS_KEY – esta es su clave API de producción del Builder Console que obtuvo antes al configurar el objeto scriptable SequenceConfig
    5. Establezca el CHAIN_HANDLE – si no está seguro de cuál es, puede ver el CHAIN_HANDLE de cada red respectiva en la página Node Gateway del Builder Console.
  2. pnpm dev – esto implementará el servidor localmente. Debería ver en la línea de comandos a qué localhost se implementó
  3. Abra otra ventana de línea de comandos
  4. curl http://localhost:8787 – sustituya el localhost que le hayan asignado. Esto enviará un ping al servidor.
  5. En la línea de comandos donde está corriendo el servidor localhost, debería ver que la dirección del wallet del minter ha sido registrada
  6. Otorgue permisos de minteo a esta dirección en el Builder Console
    1. Busque el contrato bajo Contracts y haga clic para abrirlo
    2. Haga clic en Write Contract
    3. Expanda grantRole
    4. En role ingrese 0x9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a6 – este es el hash Keccak-256 de MINTER_ROLE
    5. En account pegue la dirección del wallet del minter
  7. wrangler deploy – esto implementará el código en un Cloudflare Worker y le dará una URL de minteo
¡Listo! Ahora, cuando enviamos una solicitud POST a nuestro servidor con un cuerpo definido en C#, donde el proof es generado por el cliente que envía la solicitud de minteo. En el Unity SDK esto se implementa mediante el MintingRequestProver.

​
Manejar los tokens comprados por IAP con el Remote Minter

Arriba, desplegamos un remote minter que es útil para mintear tokens que pueden ganarse mediante acciones dentro del juego. Veamos cómo podemos aprovechar este servidor para también mintear tokens que se pueden comprar vía IAP. Notará que también se puede incluir un recibo en el payload enviado al remote minter. Aquí es donde incluirá el recibo IAP de Google/Apple. Unity recomienda usar el proyecto IAP de Nobuyori Takahashi para verificar los recibos IAP recibidos vía Unity IAP en el servidor. Una vez que haya validado el recibo en el servidor, puede continuar con su lógica de minteo, usando el código de ejemplo provisto arriba como referencia.

​
Implementación en Unity

En el lado de Unity, el primer paso es integrar Unity IAP en su proyecto. En sus métodos ProcessPurchase en su IStoreListener del proceso de integración, querrá iniciar el proceso de minteo. En Jelly Forest, esto se hace a través de los scripts UnityIAP y PremiumItem. En cuanto al payload, puede ver en la implementación de PremiumItem que estoy agregando una PermissionedMintTransaction a un TransactionQueuer. 
public void AddToPremiumTransactionQueue(PermissionedMintTransaction payload, string iapReceipt)
{
    PremiumIAPMinter minter = new PremiumIAPMinter(new MintingRequestProver(Wallet, Chain),
        _mintEndpoint, ContractAddress, iapReceipt);
    _permissionedMinterTransactionQueuer.Enqueue((payload, minter));
}
donde _permissionedMinterTransactionQueuer es un PermissionedMinterTransactionQueuer. Esto enviará un payload en este formato: 
ProofPayload: 
{
    "app": "Made with Sequence Unity SDK App",
    "iat": (uint)DateTimeOffset.UtcNow.ToUnixTimeSeconds(), // issued at time 
    "exp": (uint)DateTimeOffset.UtcNow.ToUnixTimeSeconds() + 300, // expiry time 
    "ogn": "Sequence Unity SDK",
    "payload": {
        "contractAddress": "0xabc123...",
        "tokenId": "11",
        "amount": 5,
        "receipt": <IAP Receipt String here>
    }
}

This JSON get stringified and included in the MintingRequestProof:
{
    "Proof": "{\"app\": \"Made with Sequence Unity SDK App\", \"iat\": ...}",
    "SignedProof": "0x123def...", // proof signed by the player's embedded wallet
    "SigningAddress": "0xa1b2c3..." // the player's embedded wallet address
}
Para más información sobre los TransactionQueuer, consulte este documento.
Apple y Google permiten a los usuarios la opción de hacer un contracargo de una compra IAP hecha por error. En este caso, su usuario aún tendrá el/los token(s) minteados. Aunque puede manejar esto por medios tradicionales (por ejemplo, prohibiendo a jugadores que frecuentemente hacen contracargos), debe tener cuidado de no vender NFT de alto valor por este método debido al riesgo de contracargos fraudulentos.