From 12f0eeee0c88e6efd6c6625ba21bba7d5576ea30 Mon Sep 17 00:00:00 2001 From: Tomasz Dysinski Date: Thu, 9 Apr 2026 00:49:02 -0700 Subject: [PATCH 1/2] gas sponsorship doc improvement as it relates to deployment --- solutions/builder/collections/quickstart.mdx | 3 +++ .../contracts/deploy-ERC20-currency.mdx | 3 +++ .../contracts/deploy-an-item-collection.mdx | 5 ++++- .../deploy-primary-sales-contract.mdx | 8 +++++++ .../contracts/deploy-soulbound-token.mdx | 5 ++++- solutions/builder/contracts/overview.mdx | 6 +++++ solutions/builder/gas-sponsorship.mdx | 22 +++++++++++++++---- 7 files changed, 46 insertions(+), 6 deletions(-) diff --git a/solutions/builder/collections/quickstart.mdx b/solutions/builder/collections/quickstart.mdx index 1508c9d1..137c0a38 100644 --- a/solutions/builder/collections/quickstart.mdx +++ b/solutions/builder/collections/quickstart.mdx @@ -45,6 +45,9 @@ And complete your contract details, specifying the `Network`, `Contract Name`, a ![contract details](/images/collections/collections_deploy_contract.png) + +If you deploy from Builder on production networks, treat the deployment as self-funded. Gas Sponsorship can still be useful for relayed interactions after the contract is deployed, but the deployment transaction itself may still require the deploying wallet to pay gas. + Then you will notice if you check out the `Read Contract` section tab of the contract, if you `Read` from the `baseURI` it will show you the metadata url from Sequence where when read from the Indexer, `.json` will get appended to the end to reference the json for the collectible. ![read base uri](/images/collections/collection_read_base_uri.png) diff --git a/solutions/builder/contracts/deploy-ERC20-currency.mdx b/solutions/builder/contracts/deploy-ERC20-currency.mdx index 25da1183..4ae0269d 100644 --- a/solutions/builder/contracts/deploy-ERC20-currency.mdx +++ b/solutions/builder/contracts/deploy-ERC20-currency.mdx @@ -68,6 +68,9 @@ Deploy your contract from the popup window at http://sequence.app/sign-transacti + +On production networks, treat Builder deployments as self-funded. Even if you have configured Gas Sponsorship for related wallets or contracts, the wallet performing the deployment may still need enough native gas token to pay for the deployment transaction. + All testnets will be free to transact on diff --git a/solutions/builder/contracts/deploy-an-item-collection.mdx b/solutions/builder/contracts/deploy-an-item-collection.mdx index fd7df820..0deff20a 100644 --- a/solutions/builder/contracts/deploy-an-item-collection.mdx +++ b/solutions/builder/contracts/deploy-an-item-collection.mdx @@ -45,10 +45,13 @@ Then make your choice of Web3 Game Item Collection (ERC1155) or NFT Collection ( ## Step 3: Specify contract details -Complete the contract details by specifying a `Contract Name` and `Owner` for your contract, with the option to input Royalties. Make sure the Owner address is the Sequence Wallet in the top-right hand corner and that you have funds in this wallet on mainnet, otherwise on testnet - we sponsor these transactions for you. +Complete the contract details by specifying a `Contract Name` and `Owner` for your contract, with the option to input Royalties. Make sure the Owner address is the Sequence Wallet in the top-right hand corner and that you have funds in this wallet on production networks, otherwise on testnet - we sponsor these transactions for you. ![deploy game item](/images/collectibles/deploy_game_item.png) + +On production networks, treat Builder deployments as self-funded. Even if you have configured Gas Sponsorship for related wallets or contracts, the wallet performing the deployment may still need enough native gas token to pay for the deployment transaction. + Note: diff --git a/solutions/builder/contracts/deploy-primary-sales-contract.mdx b/solutions/builder/contracts/deploy-primary-sales-contract.mdx index c01ae5e2..fe117ec9 100644 --- a/solutions/builder/contracts/deploy-primary-sales-contract.mdx +++ b/solutions/builder/contracts/deploy-primary-sales-contract.mdx @@ -9,6 +9,14 @@ sidebarTitle: Deploy a Primary Sales Contract This guide walks through how to setup and deploy the contracts for launching a primary sale - suitable for an NFT Drop, in-game store, and more. + +Current Builder behavior: + +Treat Builder contract deployments as self-funded transactions on production networks. Even if you have configured Gas Sponsorship for related wallets or contracts, the wallet performing the deployment may still need enough native gas token to pay for deployment. + +After the contracts are deployed, sponsorship can still be used for supported relayed interactions with those contracts. + + diff --git a/solutions/builder/contracts/deploy-soulbound-token.mdx b/solutions/builder/contracts/deploy-soulbound-token.mdx index c32cee91..db24e38c 100644 --- a/solutions/builder/contracts/deploy-soulbound-token.mdx +++ b/solutions/builder/contracts/deploy-soulbound-token.mdx @@ -37,11 +37,14 @@ Select either Web3 Game Item Collection (ERC1155) or NFT Collection (ERC721) for ## Step 3: Specify contract details -Provide details for the contract by specifying a `Contract Name` and `Owner`. You also have the option to set Royalties. Ensure that the Owner address matches the Sequence Wallet in the top-right corner, with adequate funds in this wallet on mainnet. For testnet transactions, we sponsor them for you. +Provide details for the contract by specifying a `Contract Name` and `Owner`. You also have the option to set Royalties. Ensure that the Owner address matches the Sequence Wallet in the top-right corner, with adequate funds in this wallet on production networks. For testnet transactions, we sponsor them for you. ![deploy game item](/images/collectibles/deploy_game_item.png) +On production networks, treat Builder deployments as self-funded. Even if you have configured Gas Sponsorship for related wallets or contracts, the wallet performing the deployment may still need enough native gas token to pay for the deployment transaction. + + Note: Changing the `name` later will update it across the Sequence stack, but popular explorers will not reindex the information. Your initial entry will remain in these systems. diff --git a/solutions/builder/contracts/overview.mdx b/solutions/builder/contracts/overview.mdx index d303c777..6dd74068 100644 --- a/solutions/builder/contracts/overview.mdx +++ b/solutions/builder/contracts/overview.mdx @@ -9,6 +9,12 @@ sidebarTitle: Overview Sequence Builder simplifies smart contract deployment and management with a suite of user-friendly features. Import, deploy, and add contract collaborators to a smart contract in the contracts dashboard and interact directly with your contract. + +On production networks, treat Builder contract deployments as self-funded transactions. Even if you have configured Gas Sponsorship for related wallets or contracts, the deploying wallet may still need enough native gas token to pay for the deployment transaction. + +Gas Sponsorship is better thought of as support for relayed interactions after a contract is already deployed. + + ##### What are my deployment options? Deployment of contracts with Sequence Builder is simplified through a streamlined process directly within our dashboard. Choose from various contract templates (ERC1155, ERC721, ERC20). The Builder also gives you the option to upload your own custom contracts - saved to your project - and can be deployed directly to a network of your choosing. diff --git a/solutions/builder/gas-sponsorship.mdx b/solutions/builder/gas-sponsorship.mdx index 90dc03dd..c604062c 100644 --- a/solutions/builder/gas-sponsorship.mdx +++ b/solutions/builder/gas-sponsorship.mdx @@ -9,6 +9,16 @@ sidebarTitle: Gas Sponsorship When a user utilizes a Sequence wallet, we offer the compatibility of sponsoring gas on any chain for your users - either at the contract or address level. This means higher conversion rates to smooth the onboarding experience for your users. By default, Sequence sponsors all gas on testnets for a smooth developer experience, however we recommend when going to Mainnet that sponsor gas for your users. + +Current Builder behavior: + +Treat Builder contract deployments on production networks as self-funded transactions. Even if you add a wallet or contract under Gas Sponsorship, deploying a new contract from Builder, including most factory-based deployments, may still require the deploying wallet to pay network gas. + +Gas sponsorship is most reliable for relayed interactions with contracts that are already deployed. + +Sponsoring a wallet address is broader than sponsoring a contract address. A sponsored wallet can cover relayed transactions from that wallet on the sponsored network beyond a single contract, while sponsoring a contract address is the narrower option. + + ##### Why would I want to sponsor gas for my app? Obtaining the crypto needed to cover gas fees poses a challenge for onboarding your users. Sponsoring gas on their behalf solves this problem, ultimately leading to higher conversion rates and retention. @@ -25,7 +35,7 @@ To create a project, follow [this walkthrough](/solutions/builder/project-manage If you have a project already, sign in and select from the listed projects. - + First, navigate to the [gas sponsorship overview page](https://sequence.build/project/default/relayer?view=overview). @@ -37,7 +47,9 @@ Or, `Add Contract` to select a smart contract that you'd like to sponsor. ![select relayer network](/images/builder/builder_gas_sponsoring_add_contract.png) - + +Wallet sponsorship and contract sponsorship are scoped differently. Sponsoring a wallet can cover that wallet's relayed transactions across many contracts on the selected network. Sponsoring a contract can benefit many users, but only when they interact with that specific contract. + Now, we are going to add a payment method via a credit card in order to fund the sponsorship. Go to the [gas sponsorship configuration](https://sequence.build/project/default/relayer?view=gas-tank) and select Setup Payment Method. @@ -51,10 +63,12 @@ We will automatically notify you if your balance falls below $5 and you have spo -We recommend testing out your sponsorships prior to launching. Simply call the contract or use your sponsored wallet for a mainnet transaction. You should shortly see the sponsored transactions list populating with these transactions - all gas free. +We recommend testing out your sponsorships prior to launching. After the contract is already deployed, call the contract or use your sponsored wallet for a mainnet transaction. You should shortly see the sponsored transactions list populating with these transactions. + +Do not use a Builder contract deployment as your sponsorship test, since deployment transactions may still require the deploying wallet to pay gas. ## Ecosystem Gas Sponsorship -We also offer the capability to sponsor all transactions for your ecosystem where we orchestrate a number of signers through our relayer at the chain level. This means any developer building on your ecosystem as well as any user of Sequence wallets has the best onboarding and UX experience possible. Please feel free to [contact us](https://support.sequence.xyz) to set this up for your ecosystem. \ No newline at end of file +We also offer the capability to sponsor all transactions for your ecosystem where we orchestrate a number of signers through our relayer at the chain level. This means any developer building on your ecosystem as well as any user of Sequence wallets has the best onboarding and UX experience possible. Please feel free to [contact us](https://support.sequence.xyz) to set this up for your ecosystem. From b42a4d81b5c7e156ee61bf6723c3b06418f6856f Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Thu, 9 Apr 2026 07:52:27 +0000 Subject: [PATCH 2/2] chore(i18n): update translations [en] Sync file structure, format locales. Branch: 221/merge --- .../builder/collections/quickstart.mdx | 124 ++++++++++++++++ .../contracts/deploy-ERC20-currency.mdx | 132 +++++++++++++++++ .../contracts/deploy-an-item-collection.mdx | 134 ++++++++++++++++++ .../deploy-primary-sales-contract.mdx | 96 +++++++++++++ .../contracts/deploy-soulbound-token.mdx | 67 +++++++++ es/solutions/builder/contracts/overview.mdx | 58 ++++++++ es/solutions/builder/gas-sponsorship.mdx | 69 +++++++++ .../builder/collections/quickstart.mdx | 124 ++++++++++++++++ .../contracts/deploy-ERC20-currency.mdx | 130 +++++++++++++++++ .../contracts/deploy-an-item-collection.mdx | 128 +++++++++++++++++ .../deploy-primary-sales-contract.mdx | 96 +++++++++++++ .../contracts/deploy-soulbound-token.mdx | 67 +++++++++ ja/solutions/builder/contracts/overview.mdx | 58 ++++++++ ja/solutions/builder/gas-sponsorship.mdx | 69 +++++++++ 14 files changed, 1352 insertions(+) create mode 100644 es/solutions/builder/collections/quickstart.mdx create mode 100644 es/solutions/builder/contracts/deploy-ERC20-currency.mdx create mode 100644 es/solutions/builder/contracts/deploy-an-item-collection.mdx create mode 100644 es/solutions/builder/contracts/deploy-primary-sales-contract.mdx create mode 100644 es/solutions/builder/contracts/deploy-soulbound-token.mdx create mode 100644 es/solutions/builder/contracts/overview.mdx create mode 100644 es/solutions/builder/gas-sponsorship.mdx create mode 100644 ja/solutions/builder/collections/quickstart.mdx create mode 100644 ja/solutions/builder/contracts/deploy-ERC20-currency.mdx create mode 100644 ja/solutions/builder/contracts/deploy-an-item-collection.mdx create mode 100644 ja/solutions/builder/contracts/deploy-primary-sales-contract.mdx create mode 100644 ja/solutions/builder/contracts/deploy-soulbound-token.mdx create mode 100644 ja/solutions/builder/contracts/overview.mdx create mode 100644 ja/solutions/builder/gas-sponsorship.mdx diff --git a/es/solutions/builder/collections/quickstart.mdx b/es/solutions/builder/collections/quickstart.mdx new file mode 100644 index 00000000..4b370093 --- /dev/null +++ b/es/solutions/builder/collections/quickstart.mdx @@ -0,0 +1,124 @@ +--- +title: Gestionar colecciones de NFT en Sequence Builder +description: Sequence Builder le permite gestionar Colecciones de metadatos de coleccionables, incluyendo detalles, imágenes y propiedades. Puede vincular Colecciones a contratos desplegables para flujos de creación sencillos. Controle las actualizaciones y la visualización pública/privada de la información de la colección en los servidores de Sequence. +sidebarTitle: Descripción general +--- + +Sequence Builder ofrece la posibilidad de gestionar Colecciones de metadatos de coleccionables, incluyendo: detalles, imágenes y propiedades de los coleccionables. Dentro del Builder, las Colecciones pueden vincularse a contratos desplegables desde el Builder para flujos de creación sencillos. + +Los medios y metadatos se guardan en los servidores de Sequence, donde ciertas funciones le permiten tener control sobre las actualizaciones y la visualización pública o privada de la información de su colección. + + + También están disponibles [APIs](/api-references/metadata/overview) para gestionar los metadatos de su colección de NFT. + + +## 1. Crear una Colección +Primero, navegue a su proyecto desde el menú desplegable en la parte superior izquierda de [Sequence Builder](https://sequence.build) y seleccione la vista de página `Collections` en la barra lateral izquierda, luego haga clic en `+ Create a collection` + + + ![crear colección](/images/collections/collections_create_collection.png) + + +Luego ingrese los detalles de la colección, como el `Collection Name`, la `Description` para la información del contrato, y en `Collection Data` elija si será `Visible (Public)` o `Private (Hidden)`. Para que los datos sean visibles, seleccione Visible (Public). Incluya también el `External Link` de su proyecto a un sitio web. + + + ![agregar detalles a la colección](/images/collections/collections_create_collection_input_details.png) + + +## 2. Vincular un Contrato +Después de crear una colección, puede vincular un contrato desplegando un contrato de coleccionables (por ejemplo, `ERC1155` o `ERC721`) y configurando el `baseMetadataURI` durante el despliegue al seleccionar `Link contract` + +Luego seleccione `Deploy new contract` + + + ![vincular un contrato](/images/collections/collections_collections_link_contract.png) + + +Seleccione el tipo de contrato o cargue uno propio + + + ![tipo de contrato](/images/collections/collections_link_contract_choose_contract_type.png) + + +A continuación, podrá ver los detalles del tipo de contrato seleccionado + + + ![tipo de contrato elegido](/images/collections/collections_link_contract_confirm_contract.png) + + +Complete los detalles del contrato, especificando la `Network`, el `Contract Name` y los `Royalties`, si desea publicar el coleccionable en el [Token Directory](/api-references/indexer/examples/metadata-tips) y finalmente seleccione `Deploy Contract` para completar la firma de la transacción en la ventana emergente de Sequence. + + + ![detalles del contrato](/images/collections/collections_deploy_contract.png) + + + + Si despliega desde Builder en redes de producción, trate el despliegue como autofinanciado. El Gas Sponsorship puede seguir siendo útil para interacciones retransmitidas después de desplegar el contrato, pero la transacción de despliegue en sí puede requerir que la wallet que despliega pague el gas. + + +Luego, si revisa la pestaña `Read Contract` del contrato y hace clic en `Read` sobre el campo `baseURI`, verá la URL de los metadatos de Sequence. Cuando se consulta desde el Indexer, se añade `.json` al final para referenciar el json del coleccionable. + + + ![leer base uri](/images/collections/collection_read_base_uri.png) + + +## 3. Crear un Coleccionable +Para crear un coleccionable como parte de la colección, regrese a la página `Collections` y seleccione `+ Add a collectible` + + + ![agregar un coleccionable](/images/collections/collections_add_a_collectible.png) + + +Luego actualice los detalles como el `Collectible Name` y la `Description`, y cargue su arte seleccionando el campo gris. + + + ![actualizar detalles del coleccionable](/images/collections/collections_update_art_and_details.png) + + +#### Agregar una propiedad de metadatos +También puede agregar ciertas propiedades a su coleccionable seleccionando `+ Add a property`, lo cual es útil para inscribir información adicional como números o cadenas de texto cuando se usan los metadatos en cualquier juego. + + + ![agregar una propiedad](/images/collections/collection_add_property.png) + + +Asigne la clave y el valor a cada propiedad + + + ![asignar propiedades](/images/collections/collection_assign_properties.png) + + +Complete los pasos anteriores hasta obtener el resultado final de un coleccionable agregado a una colección + + + ![resultado final del coleccionable agregado](/images/collections/collections_final_result_of_collectible.png) + + +## 4. Actualizar información en Configuración +En cualquier momento puede actualizar los detalles de su coleccionable en configuración + + + ![configuración](/images/collections/collections_access_settings.png) + + +Una vez en configuración, puede actualizar cualquiera de los campos de información, como: `Collection Name`, `Description`, visibilidad de los `Collection data` y un `External Link` para referenciar un sitio web. + + + ![configuración](/images/collections/collections_update_info.png) + + +#### Eliminar datos de la colección +Puede eliminar todos los datos de la colección del contrato seleccionando `Delete collection data`, lo que eliminará permanentemente todos los datos. Esta acción no se puede deshacer. + +## 5. Referenciar el Metadata Token URI +Actualmente, para `Link Contract` no puede usar contratos predesplegados, pero puede leer el `Token Metadata URI` de la colección para configurar el `setBaseMetadataURI` de sus contratos existentes. El URI se puede obtener accediendo al botón `Metadata URIs` + + + ![copiar metadata uris](/images/collections/collections_metadata_uris.png) + + +Luego copie el `Token Metadata URI` desde la ventana modal y utilícelo para escribir en un contrato con la función `setBaseMetadataURI`, o úselo para referenciar metadatos directamente en una aplicación agregando `.json` al URI para acceder a los metadatos. + + + ![acceder a metadata uris](/images/collections/collections_token_metadata_uri.png) + \ No newline at end of file diff --git a/es/solutions/builder/contracts/deploy-ERC20-currency.mdx b/es/solutions/builder/contracts/deploy-ERC20-currency.mdx new file mode 100644 index 00000000..dada78f8 --- /dev/null +++ b/es/solutions/builder/contracts/deploy-ERC20-currency.mdx @@ -0,0 +1,132 @@ +--- +title: Cómo desplegar moneda dentro del juego en Sequence Builder +description: Aprenda cómo crear su propia moneda dentro del juego desplegando y minteando desde un contrato ERC20. Comprenda la diferencia entre tokens fungibles y no fungibles. +sidebarTitle: Desplegar una moneda dentro del juego (ERC20) +--- + +## Introducción +En esta guía, le mostraremos el proceso para crear su propia moneda dentro del juego mediante el despliegue y minteo desde un contrato ERC20. + +Los tokens de moneda agregan nuevas e interesantes dimensiones a las economías dentro del juego, las transacciones y la interacción entre jugadores para desbloquear y distribuir valor. + +#### ¿Qué es un token ERC20? +Un token ERC20 es una moneda digital: lo que lo hace especial es que sigue un [conjunto de reglas llamado ERC20](https://ethereum.org/en/developers/docs/standards/tokens/erc-20/), lo que facilita su uso en diferentes lugares de internet. Estos tokens suelen representar valor o utilizarse para fines específicos. A diferencia de los otros tokens comunes, los NFT, estos tokens son fungibles. + +#### Fungibilidad vs No Fungibilidad +Esta es la diferencia clave que debe comprender. + +Los tokens fungibles (como los tokens ERC20) son intercambiables y cada unidad es igual a cualquier otra, como los dólares o euros. Se pueden dividir o combinar fácilmente en diferentes cantidades. + +Los tokens no fungibles (como los tokens ERC721) representan artículos únicos con propiedades individuales, como arte digital o coleccionables. Cada token es distinto y no se puede intercambiar directamente por otro de manera equivalente. + + + Requisito previo: Crear un Proyecto + + Esta guía asume que usted ya [se registró en Builder y creó un Proyecto](/solutions/builder/getting-started). + + +## Paso 1: Navegue a contratos +Comience seleccionando su `project` en la esquina superior izquierda del proyecto para el que desea crear la moneda, luego diríjase a la sección de `contracts` y seleccione `+ Deploy new contract` + + + ![seleccionar proyecto y nuevo contrato](/images/collectibles/select_project_new_contract.png) + + +## Paso 2: Seleccione el token de moneda +Haga clic en `View more contracts` + + + ![ver más tokens de moneda](/images/collectibles/view_more_contracts.png) + + +Seleccione el contrato de token de moneda y haga clic en `deploy` para desplegar su contrato auditado por Sequence + + + ![seleccionar token de moneda y botón de deploy](/images/collectibles/select_currency_deploy.png) + + +## Paso 3: Especifique los detalles del contrato +Complete los detalles del contrato especificando un `name` y un `symbol` para su contrato. + + + ![seleccionar currency y botón de deploy](/images/collectibles/currency_contract_details.png) + + + + Nota: + + Aunque puede cambiar el `name` y el `symbol` más adelante en la interfaz de builder, donde se actualizará en todo el stack de Sequence, los exploradores populares no vuelven a indexar la información, así que lo que ingrese primero permanecerá. + + +## Paso 4: Despliegue su contrato +Despliegue su contrato desde la ventana emergente en [http://sequence.app/sign-transaction](http://sequence.app/sign-transaction) y firme el mensaje seleccionando `confirm` + + + + + + + En redes de producción, trate los despliegues desde Builder como autofinanciados. Incluso si ha configurado Gas Sponsorship para wallets o contratos relacionados, la wallet que realiza el despliegue puede necesitar suficiente token de gas nativo para pagar la transacción de despliegue. + + + + Todas las testnets serán gratuitas para transaccionar. + + +## Paso 5: Agregue un rol de minteo al contrato +Primero seleccione el contrato que acaba de desplegar en la sección de `contracts` + + + ![seleccionar contrato](/images/collectibles/select_contract.png) + + +Luego, diríjase a la sección `Write Contract` + + + ![escribir contrato](/images/collectibles/select_write_contract.png) + + +En la sección `grantRole` de la navegación de la pestaña write contract, complete con los siguientes datos: + +`bytes32 role`: `0x9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a6` +`address account`: `` + +Donde la dirección de la wallet se copia simplemente desde la esquina superior derecha para poder enviar tokens a su wallet + + + ![copiar dirección](/images/collectibles/copy_address.png) + + + + ![otorgar rol de minteo](/images/collectibles/grant_role.png) + + +Finalice seleccionando `write` y firmando la transacción en la ventana emergente, como antes + +Con un mensaje de confirmación que muestra `Response Success` + + + La cadena de rol ingresada es el resultado de `solidityPackedKeccak256("MINTER_ROLE")` en + solidity o `ethers.solidityPackedKeccak256(ethers.toUtf8Bytes("MINTER_ROLE"))` + en javascript + + + + Es común utilizar cómputo offchain como un worker de cloudflare con una wallet relayer que envía transacciones, la cual se ingresaría en el campo account. Más información sobre cómo lograr esto [aquí](/guides/mint-collectibles-serverless#mint-collectibles-using-a-gasless-serverless-transactions-api) + + +## Paso 6: Mintee tokens en la dirección de su wallet +Navegue a la tarjeta `mint` en la sección `Write Contract` e ingrese la dirección de su wallet a la que desea recibir tokens y la cantidad de tokens en 18 decimales. Así que para 100 tokens debe ingresar: `100000000000000000000` + + + ![mintear tokens](/images/collectibles/mint_currency.png) + + +## Paso 7: Confirme su token de moneda minteado +¡Y listo! + +Puede ver las transacciones enviadas a la blockchain para la dirección de su wallet en la navegación de la pestaña `Transactions` + + + ![ver transacciones de token de moneda](/images/collectibles/view_currency_transactions.png) + \ No newline at end of file diff --git a/es/solutions/builder/contracts/deploy-an-item-collection.mdx b/es/solutions/builder/contracts/deploy-an-item-collection.mdx new file mode 100644 index 00000000..6031070a --- /dev/null +++ b/es/solutions/builder/contracts/deploy-an-item-collection.mdx @@ -0,0 +1,134 @@ +--- +title: Cómo desplegar un contrato de colección de ítems en Sequence Builder +description: Esta guía ofrece un recorrido detallado sobre cómo configurar y desplegar un contrato de Web3 Game Item en Builder. Explica las diferencias entre los contratos ERC721 y ERC1155 y describe los pasos para desplegar un contrato. +sidebarTitle: Desplegar un contrato de colección +--- + +Esta guía explica cómo configurar y desplegar un contrato de Web3 Game Item en Builder. + + + Requisito previo: Crear un Proyecto + + Esta guía asume que usted ya [se registró en Builder y creó un Proyecto](/solutions/builder/getting-started). + + +#### ERC721 vs. ERC1155 +Ambos contratos mintean NFTs, pero ERC721, al ser el estándar más antiguo, ha logrado una amplia adopción, especialmente en coleccionables digitales. Conocido por su simplicidad y facilidad de auditoría en seguridad, los tokens ERC721 son únicos, lo que contribuye a su reconocimiento en varios marketplaces de NFT. Normalmente usaría un contrato ERC721 si: está gestionando un único activo repetido varias veces, o una colección compuesta por un solo tipo de ítem con múltiples ejemplares. + +Ejemplo de `ERC721`: [Azuki](https://etherscan.io/token/0xed5af388653567af2f388e6224dc7c4b3241c544) + +En cambio, ERC1155 ofrece versatilidad con operaciones por lotes eficientes tanto para tokens fungibles como no fungibles en un solo contrato, donde normalmente se maneja una multiplicidad de muchos ítems en muchas cantidades. Sin embargo, esta flexibilidad introduce complejidad, por lo que requiere atención cuidadosa en seguridad. + +Ejemplo de `ERC1155`: [Skyweaver](https://polygonscan.com/token/0x631998e91476da5b870d741192fc5cbc55f5a52e) + +## Paso 1: Navegue a contratos +Comience seleccionando su `project` en la esquina superior izquierda para el cual desea crear el coleccionable, luego diríjase a la sección de `contracts` y seleccione `+ Deploy new contract` + + + ![seleccionar proyecto y nuevo contrato](/images/collectibles/deploy_new_contract.png) + + +## Paso 2: Elija el tipo de coleccionable +Luego, elija entre Web3 Game Item Collection (ERC1155) o NFT Collection (ERC721). En este ejemplo le mostraremos cómo crear una Web3 Game Item Collection (ERC1155) + + + ![seleccionar game item](/images/collectibles/select_web3_game_item.png) + + + + La única diferencia en el despliegue entre un `ERC1155` y un `ERC721` es que + se agrega un `symbol` a una colección de NFT ERC721 + + +## Paso 3: Especifique los detalles del contrato +Complete los detalles del contrato especificando un `Contract Name` y un `Owner` para su contrato, con la opción de ingresar Royalties. Asegúrese de que la dirección del Owner sea la Sequence Wallet que aparece en la esquina superior derecha y que tenga fondos en esta wallet en redes de producción; de lo contrario, en testnet, nosotros patrocinamos estas transacciones por usted. + + + ![desplegar game item](/images/collectibles/deploy_game_item.png) + + + + En redes de producción, trate los despliegues desde Builder como autofinanciados. Incluso si ha configurado Gas Sponsorship para wallets o contratos relacionados, la wallet que realiza el despliegue puede necesitar suficiente token de gas nativo para pagar la transacción de despliegue. + + + + Nota: + + Aunque puede cambiar el `name` más adelante en la interfaz de builder, donde se actualizará en todo el stack de Sequence, los exploradores populares no vuelven a indexar la información, así que lo que ponga primero permanecerá. + + +## Paso 4: Despliegue su contrato +Despliegue su contrato desde la ventana emergente en [http://sequence.app/sign-transaction](http://sequence.app/sign-transaction) y firme el mensaje seleccionando `confirm` + + + Despliegue su contrato firmando el mensaje en la ventana emergente desde la Sequence Wallet + + + + Todas las testnets serán gratuitas para transaccionar. + + +### Opcional: Agregue un rol de Minter al contrato +Los contratos de Sequence tienen opciones de Access Control por defecto. En algunos casos, puede que desee otorgar permisos a una dirección específica para llamar a funciones como `mint()`. + +Primero seleccione el contrato que acaba de desplegar en la sección de `contracts` + + + ![seleccionar contrato](/images/collectibles/select_deployed_contract.png) + + +Luego, diríjase a la sección `Write Contract` + + + ![escribir contrato](/images/collectibles/select_item_write_contract.png) + + +En la sección `grantRole` de la navegación de la pestaña write contract + + + ![otorgar rol](/images/collectibles/grant_role_game_item.png) + + +Complete con los siguientes datos: + +`bytes32 role`: `0x9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a6` +`address account`: `` + +Donde la dirección de wallet es la dirección a la que desea dar permisos para mintear, específicamente cualquier Sequence wallet. + + + ![copiar dirección](/images/collectibles/copy_address_game_item.png) + + +Finalice seleccionando `write` y firmando la transacción en la ventana emergente, como antes + +Con un mensaje de confirmación que muestra `Response Success` + + + La cadena de rol ingresada es el resultado de `solidityPackedKeccak256("MINTER_ROLE")` en + solidity o `ethers.solidityPackedKeccak256(ethers.toUtf8Bytes("MINTER_ROLE"))` + en javascript + + + + Es común usar cómputo offchain como un worker de Cloudflare con una + wallet relayer que envía transacciones, la cual se ingresaría en el campo account. + Puede ver más sobre cómo lograr esto + [aquí](/guides/mint-collectibles-serverless#mint-collectibles-using-a-gasless-serverless-transactions-api) + + +## Paso 6: Mintee tokens en la dirección de su wallet +Vaya a la tarjeta `mint` en la sección `Write Contract` e ingrese el `to`, que es la dirección del wallet al que desea enviar el token, el `tokenId` (normalmente comenzando en 0), la `amount` de tokens, y finalmente en la sección `data` puede ingresar simplemente `0x00`, que usualmente representa datos adicionales sin formato específico. + + + ![mintear tokens](/images/collectibles/mint_game_item.png) + + +## Paso 7: Confirme su coleccionable minteado +¡Y listo! + +Puede ver las transacciones enviadas a la blockchain para la dirección de su wallet en la navegación de la pestaña `Transactions` + + + ![ver transacciones de moneda](/images/collectibles/transactions_game_items.png) + \ No newline at end of file diff --git a/es/solutions/builder/contracts/deploy-primary-sales-contract.mdx b/es/solutions/builder/contracts/deploy-primary-sales-contract.mdx new file mode 100644 index 00000000..cedf441d --- /dev/null +++ b/es/solutions/builder/contracts/deploy-primary-sales-contract.mdx @@ -0,0 +1,96 @@ +--- +title: Desplegar un contrato de ventas primarias en Sequence Builder +description: Esta guía ofrece un recorrido detallado sobre cómo configurar e implementar un contrato de ventas primarias en Builder. Explica las diferencias entre los contratos ERC721 y ERC1155, y detalla los pasos para desplegar un contrato. +sidebarTitle: Implemente un contrato de ventas primarias +--- + +### Cómo implementar un contrato de ventas primarias en Sequence Builder +Esta guía explica cómo configurar e implementar los contratos para lanzar una venta primaria, ideal para un NFT Drop, una tienda dentro del juego y más. + + + Comportamiento actual de Builder: + + Considere los despliegues de contratos desde Builder como transacciones autofinanciadas en redes de producción. Incluso si ha configurado Gas Sponsorship para wallets o contratos relacionados, la wallet que realiza el despliegue puede necesitar suficiente token de gas nativo para pagar el despliegue. + + Después de desplegar los contratos, el patrocinio puede seguir utilizándose para interacciones retransmitidas compatibles con esos contratos. + + + + + Comience seleccionando el `project` para el cual desea crear una venta y diríjase a `Contracts > Deploy`. + + + + Siga esta [guía](/solutions/builder/contracts/deploy-an-item-collection) para desplegar un contrato de coleccionables y subir los metadatos de la colección para la que desea crear una venta. + + + ![seleccionar game item](/images/collectibles/select_web3_game_item.png) + + + + + Una vez implementado correctamente, regrese a la página de contratos y seleccione `+ Deploy new contract` nuevamente. Luego, elija el contrato de venta ERC721 o ERC1155 que corresponda al contrato de coleccionables que desplegó en el paso 2 y haga clic en `Deploy sale contract`. + + + ![Implementar contrato de venta](/images/collectibles/primary-sales/docs_deploy_sale.png) + + + + + Vaya a la pestaña de detalles de minteo de su contrato de ventas primarias. Complete los detalles de minteo con los parámetros de venta que desee. + + + ![Acceso de minteo](/images/collectibles/primary-sales/docs_mint_access.png) + + + - `Supply Cap`: Es la cantidad máxima de tokens que los usuarios pueden mintear a través del contrato de venta. + - `Cost`: Es el costo en GWEI para mintear un solo token. En este ejemplo, lo configuramos en 0 para facilitar el minteo desde Builder, pero en producción debe coincidir con el precio que desea cobrar a sus usuarios. + - `Start and End Time`: Fecha y hora de inicio y fin de la venta. Si la hora actual está dentro del rango proporcionado, la venta estará activa. Puede configurar el rango de fechas a futuro si lo prefiere. + - `Payment Token`: Puede seleccionar el token nativo de la red o una moneda personalizada para la venta. + - `Sale Type`: Puede elegir entre un minteo público o privado. Si selecciona un minteo privado, también puede cargar una lista de participantes permitidos usando nuestra función [Audience](https://sequence.build/project/default/audience/). Es importante tener en cuenta que, para un minteo privado, deberá proporcionar una prueba de Merkle que corresponda a la raíz de Merkle agregada en los detalles de la venta para poder mintear. No se preocupe, esta lógica ya viene incluida en nuestros boilerplates por defecto. + + Para este ejemplo, asumiremos que está creando un minteo público. + + + + Copie la dirección del contrato de ventas, luego navegue al contrato específico y seleccione la configuración para ver los permisos. + + + ![configuración del contrato](/images/builder/builder_contract_specific_settings.png) + + + Cuando tenga abierta la ventana modal, seleccione la pestaña `Permissions` y podrá `Edit`, o, `+ Add Collaborator`. + + + ![agregar colaborador](/images/builder/builder_contract_specific_permissions.png) + + + Complete el formulario con la dirección del contrato de ventas para agregarlo como colaborador y seleccione en el menú desplegable el rol de `Minter`. + + + ![asignar rol](/images/builder/builder_contract_permissions_dropdown.png) + + + Finalmente, complete y firme la transacción para actualizar el control de acceso del contrato. + + + + Ahora que tiene sus contratos configurados, ¡hagamos una prueba de minteo! + + Regrese a su contrato de venta desplegado y seleccione `Write contract`. Luego haga clic en la función `mint()` e ingrese los siguientes parámetros: + + - `to`: esta es la dirección a la que se minteará el NFT. Generalmente será el usuario que pagó, pero puede ingresar la dirección de su Builder que aparece en la esquina superior derecha. + - `amount`: La cantidad de NFTs a mintear, simplemente mintearemos 1. + - `paymentToken`: Para una moneda personalizada, ingrese la dirección de esa moneda. Para tokens nativos, utilice `0x0000000000000000000000000000000000000000`. + - `maxTotal`: El monto máximo de la moneda indicada que se puede pagar. + - `proof`: Para un minteo público, puede dejar este campo vacío. En un minteo privado, aquí debe ingresar la prueba generada que corresponde a la dirección del usuario y la raíz de Merkle previamente proporcionada. + + + ![Conceder rol de Minter](/images/collectibles/primary-sales/docs_mint_sale.png) + + + Una vez que haya completado toda la información, haga clic en `Write` para construir la transacción y luego en `Confirm` para mintear el token. + + + +¿Qué sigue? Ahora puede utilizar los contratos de venta públicamente en su sitio web para un NFT drop o usarlos en su tienda dentro del juego para vender ítems a sus jugadores. También le recomendamos revisar nuestro \[boilerplate de Sequence Pay]\(([https://github.com/0xsequence-demos/sequence-pay-boilerplate](https://github.com/0xsequence-demos/sequence-pay-boilerplate)), que utiliza los contratos de venta para habilitar casos de uso como pagos con tarjeta de crédito o la posibilidad de pagar en cualquier moneda para su venta. \ No newline at end of file diff --git a/es/solutions/builder/contracts/deploy-soulbound-token.mdx b/es/solutions/builder/contracts/deploy-soulbound-token.mdx new file mode 100644 index 00000000..432bcdcb --- /dev/null +++ b/es/solutions/builder/contracts/deploy-soulbound-token.mdx @@ -0,0 +1,67 @@ +--- +title: Cómo implementar un contrato Soulbound Token en Sequence Builder +description: Aprenda a desplegar contratos Soulbound Token en Sequence Builder para activos de juego exclusivos y no transferibles. Esta guía cubre la configuración, los pasos clave y las mejores prácticas para implementar NFTs no comerciables. +sidebarTitle: Implemente un contrato Soulbound Token +--- + +Descubra cómo configurar e implementar contratos Soulbound Token en Sequence Builder. Los Soulbound Tokens son ideales para crear activos de juego únicos y no transferibles, como Battlepasses, membresías y objetos exclusivos que permanecen permanentemente con el jugador. + +## Descripción general de los Soulbound Tokens +Los Soulbound Tokens (SBTs) son activos on-chain no transferibles y no vendibles, diseñados para ofrecer valor exclusivo y duradero en entornos Web3. Como no pueden transferirse ni intercambiarse, los SBTs son ideales para representar objetos digitales permanentes, logros o membresías. Algunos casos de uso comunes son: +- **Pases de juego y membresías**: Utilice Soulbound Tokens para Battlepasses, membresías o programas de lealtad que permanezcan de forma permanente en el wallet del usuario, asegurando acceso exclusivo para el titular. +- **Insignias de logros**: Recompense a los jugadores con insignias únicas que demuestren su progreso y logros; son visibles para todos pero no se pueden intercambiar. +- **Entradas para eventos y certificaciones**: Ofrezca entradas seguras y no transferibles para eventos exclusivos dentro del juego o certificaciones educativas por habilidades obtenidas en el entorno del juego. +- **Sistemas de identidad y reputación**: Establezca tokens basados en identidad o reputación que representen confianza o credibilidad, fomentando el juego justo y la participación de los usuarios. + +Los Soulbound Tokens son especialmente útiles para desarrolladores de juegos y comunidades que buscan ofrecer valor duradero sin necesidad de especulación comercial. + + + Requisito previo: Crear un Proyecto + + Esta guía asume que usted ya [se registró en Builder y creó un Proyecto](/solutions/builder/getting-started). + + +## Paso 1: Navegue a contratos +Comience seleccionando su `project` en la esquina superior izquierda para el cual desea crear el coleccionable, luego vaya a la sección `Deploy`, seleccione `Contracts` y luego haga clic en el botón `Contracts` para agregar un nuevo contrato. + +## Paso 2: Elija el tipo de coleccionable +Seleccione Web3 Game Item Collection (ERC1155) o NFT Collection (ERC721) para su Soulbound Token. En esta guía, usaremos Web3 Game Item Collection (ERC1155), ideal para crear Soulbound Tokens no transferibles. + +## Paso 3: Especifique los detalles del contrato +Proporcione los detalles del contrato especificando un `Contract Name` y un `Owner`. También tiene la opción de establecer Royalties. Asegúrese de que la dirección del Owner coincida con la Sequence Wallet en la esquina superior derecha y que tenga fondos suficientes en esta wallet en redes de producción. Para transacciones en testnet, nosotros las patrocinamos por usted. + + + ![desplegar game item](/images/collectibles/deploy_game_item.png) + + + + En redes de producción, trate los despliegues desde Builder como autofinanciados. Incluso si ha configurado Gas Sponsorship para wallets o contratos relacionados, la wallet que realiza el despliegue puede necesitar suficiente token de gas nativo para pagar la transacción de despliegue. + + + + Nota: + Si cambia el `name` más adelante, se actualizará en todo el stack de Sequence, pero los exploradores populares no volverán a indexar la información. Su entrada inicial permanecerá en estos sistemas. + + +## Paso 4: Despliegue su contrato +Despliegue su contrato a través de la ventana emergente en [http://sequence.app/sign-transaction](http://sequence.app/sign-transaction) y confirme firmando el mensaje. + + + Despliegue su contrato firmando el mensaje en la ventana emergente desde la Sequence Wallet + + +## Paso 5: Mintee tokens a la dirección de su wallet +Vaya a la tarjeta `mint` en la sección `Write Contract` e ingrese el `to`, que es la dirección del wallet al que desea enviar el token, el `tokenId` (normalmente comenzando en 0), la `amount` de tokens, y finalmente en la sección `data` puede ingresar simplemente `0x00`, que usualmente representa datos adicionales sin formato específico. + + + ![mintear tokens](/images/collectibles/mint_game_item.png) + + +## Paso 6: Confirme su coleccionable minteado +¡Y listo! + +Puede ver las transacciones enviadas a la blockchain para la dirección de su wallet en la navegación de la pestaña `Transactions` + + + ![ver transacciones de moneda](/images/collectibles/transactions_game_items.png) + \ No newline at end of file diff --git a/es/solutions/builder/contracts/overview.mdx b/es/solutions/builder/contracts/overview.mdx new file mode 100644 index 00000000..a8a0b19e --- /dev/null +++ b/es/solutions/builder/contracts/overview.mdx @@ -0,0 +1,58 @@ +--- +title: Contratos +description: Sequence Builder ofrece una plataforma fácil de usar para el despliegue y gestión de smart contracts. Elija entre plantillas de contratos o cargue contratos personalizados, y despliegue directamente en la red de su elección. +sidebarTitle: Descripción general +--- + +Sequence Builder simplifica el despliegue y la gestión de smart contracts con un conjunto de funciones intuitivas. Importe, despliegue y agregue colaboradores a un smart contract desde el panel de contratos e interactúe directamente con su contrato. + + + En redes de producción, trate los despliegues de contratos desde Builder como transacciones autofinanciadas. Incluso si ha configurado Gas Sponsorship para wallets o contratos relacionados, la wallet que despliega puede necesitar suficiente token de gas nativo para pagar la transacción de despliegue. + + Es mejor pensar en Gas Sponsorship como soporte para interacciones retransmitidas después de que un contrato ya está desplegado. + + +##### ¿Cuáles son mis opciones de despliegue? +El despliegue de contratos con Sequence Builder se simplifica mediante un proceso ágil directamente en nuestro panel. Puede elegir entre varias plantillas de contratos (ERC1155, ERC721, ERC20). El Builder también le da la opción de cargar sus propios contratos personalizados —guardados en su proyecto— y desplegarlos directamente en la red que prefiera. + +##### ¿Qué interacciones puedo realizar con los contratos? +Sequence Builder proporciona un panel de contratos completo, permitiendo a los usuarios explorar y monitorear diversas actividades de smart contracts como transacciones, balances y tokens. Realizar operaciones de lectura y escritura en los contratos es sencillo, facilitando acciones como el minteo y la colaboración. + +## Vea cómo se despliega un contrato con Builder + + +