thirdweb ES https://paragraph.com/@samusarmiento Blog y guías oficiales de la comunidad hispanohablante de @thirdweb . Thu, 03 Sep 2026 23:45:09 GMT https://validator.w3.org/feed/docs/rss2.html https://github.com/jpmonette/feed en thirdweb ES https://storage.googleapis.com/papyrus_images/fec6a59b9d551b0e728d902d73f3c264 https://paragraph.com/@samusarmiento All rights reserved <![CDATA[Por qué apostamos fuerte por el gaming con blockchain]]> https://paragraph.com/@samusarmiento/apostamos-fuertes-en-blockchain-gaming uUcpf0riDF27RBA9oi7j Sat, 17 Jun 2023 20:01:47 GMT

El año pasado, nos asociamos con Coinbase para lanzar GamingKit de thirdweb: el kit de herramientas todo en uno para que los desarrolladores creen los mejores juegos web3.

Ahora estamos redoblando la apuesta por el gaming, lanzando una nueva división de juegos dentro de thirdweb para facilitar más que nunca a los desarrolladores de juegos el desarrollo onchain. A continuación te explicamos cómo.

¿Por qué crear juegos en la blockchain?

Los juegos han experimentado un crecimiento explosivo en la última década y, solo en 2020, los jugadores gastaron más de 54.000 millones de dólares en artículos de juego. Juegos como Fortnite, Minecraft y Roblox han creado comunidades globales masivas a través de economías de juego, objetos desbloqueables y mercados abiertos.

Pero construir la infraestructura para soportar todo esto lleva años, lo que aumenta drásticamente las barreras de entrada para los nuevos desarrolladores de juegos.

Como resultado, los desarrolladores están recurriendo a web3 para crear juegos de forma mucho más rápida, barata y sencilla, con la blockchain como plataforma subyacente y sustituyendo a los sistemas backend que han tardado años en crearse para los juegos tradicionales.

Con la innovación acelerándose más que nunca para conseguir escalabilidad en Ethereum, las redes de capa 2 están haciendo más accesible construir en la blockchain. Y con la esperada actualización de Cancún para Ethereum, que reducirá los costes de transacción 10 veces, la cadena de bloques está a punto de experimentar su mayor cambio de paradigma hasta la fecha:

En lugar de limitarse a añadir una capa de complejidad a los juegos, la cadena de bloques puede servir ahora como la mejor plataforma de su clase que sustituye a la infraestructura tradicional de backend y potencia el proceso de desarrollo de juegos.

Construir sobre la cadena de bloques reduce el tiempo de desarrollo de los juegos de años a semanas, y cientos de estudios ya la utilizan para almacenar datos y ejecutar la lógica de los juegos, de modo que puedan centrarse en lo que más importa: crear grandes juegos y, al mismo tiempo, permitir una verdadera propiedad digital para los jugadores con activos de juego interoperables basados en la blockchain.

Redoblamos la apuesta por el juego: así lo hacemos

Lanzamos GamingKit en diciembre de 2022 para permitir a los desarrolladores de juegos crear los mejores juegos web3. Desde entonces, hemos:

Y ahora, estamos encantados de anunciar que estamos lanzando una nueva división de juegos dentro de thirdweb: la incorporación de Atif Khan en el equipo como nuestro nuevo vicepresidente de juegos - un ex ejecutivo de Facebook con más de 15 años de experiencia en la industria.

Más información sobre todas estas novedades y sobre lo que está por llegar a thirdweb Gaming.

Los mejores juegos web3 con thirdweb GamingKit

Creemos que web3 es el futuro de gaming, pero para que alcance una adopción masiva, los desarrolladores de juegos necesitan las herramientas para crear experiencias de juego basadas en blockchain de primera clase que rivalicen o mejoren las de los juegos tradicionales.

Por eso hemos creado GamingKit: el conjunto de herramientas todo en uno para que los desarrolladores creen grandes juegos web3.

Lanzado a finales de 2022, hemos seguido invirtiendo en nuestras herramientas de Gaming durante los últimos 6 meses - construyendo el SDK de juegos web3 más potente del mercado, con potentes características como:

  • Soporte multiplataforma: Nuestro Unity SDK soporta web, móvil (iOS, Android), escritorio (Mac, Windows), consola y desarrollo de juegos AR/VR - en cualquier blockchain compatible con EVM.

  • Experiencia Wallet sin fisuras: Nuestro Wallet SDK permite a los juegos adaptar sus experiencias "Connect Wallet" a cualquier audiencia - con soporte para más de 170 de las billeteras más populares, integración de inicio de sesión social web2, experiencias de billetera invisible con características sin gas y sin firma, y las herramientas para integrar billeteras inteligentes ERC-4337 totalmente personalizables en cualquier juego.

  • Componentes Web3 UI: Nuestro Unity SDK te permite arrastrar y soltar potentes características web3 en tu juego fácilmente - con pre-fabs para botones Connect Wallet, renderizadores NFT, y mucho más.

  • Creación de billeteras móviles: Hemos integrado Walletconnect de forma nativa para ofrecer a los usuarios la posibilidad de crear una cartera escaneando un código QR en sus teléfonos. Una integración más fluida para los usuarios no nativos de Web3.

  • Soporte de almacenamiento: Carga y descarga fácilmente archivos a IPFS y gestiona todas tus necesidades de almacenamiento sin tener que salir de nuestro panel de control.

  • Contratos inteligentes para cualquier caso de uso: Implementa sin problemas NFT, marketplaces, monederos inteligentes y otros componentes onchain con nuestros contratos inteligentes auditados pre-construidos - construidos con extensiones personalizadas para cualquier caso de uso imaginable.

  • Monetización integrada: Crea múltiples flujos de ingresos con una fácil rampa de entrada de fiat a cripto (integración de Coinbase Pay), mercados con tarifas de royalties configurables y divisiones para compartir ingresos.

Y lo mejor de todo: Nuestras herramientas son completamente modulares, lo que significa que los desarrolladores pueden utilizar nuestra pila completa, o pueden optar por utilizar algunos de nuestros productos y rellenar los huecos con otros proveedores de su elección.

Los desarrolladores de juegos están empezando a darse cuenta de que los usuarios quieren modularidad, quieren poder elegir. No necesitan estar atascados o encerrados en una sola cartera, ya sea inteligente, local, con o sin custodia. Los usuarios tienen preferencias diferentes.

- Atif Khan, vicepresidente de juegos de thirdweb

Estamos muy contentos de seguir construyendo el mejor SDK de juegos para cualquier juego web3, con planes para seguir mejorando nuestra oferta de Unity y llevar las mismas herramientas de primera clase a Unreal Engine.

Obtenga más información y comience con thirdweb GamingKit - es gratis:

Reducción del tiempo de desarrollo de juegos con web3, de años a semanas

Los juegos basados en blockchain tienen fama de ser menos inmersivos y divertidos que los juegos tradicionales, pero como constructores a la vanguardia del sector, hemos visto cómo esto ha cambiado drásticamente en los últimos años.

El GamingKit de thirdweb ya se ha utilizado para lanzar cientos de juegos web3, acelerando el desarrollo de líderes del sector como Pixels, Gala Games y Fractal:

Y para acabar con este estereotipo obsoleto, hemos ido un paso más allá. El mes pasado, utilizamos GamingKit para crear Web3 Warriors, nuestro propio juego de rol a gran escala, para demostrar cómo deberían ser los juegos de blockchain.

Gameplay from Web3 Warriors, an onchain RPG built by thirdweb

Construimos el juego utilizando tecnología blockchain en lugar de la infraestructura backend tradicional, lo que aceleró el desarrollo y nos permitió incorporar potentes funciones habilitadas para web3, como:

  • Una moneda del juego para comprar y vender objetos, basada en contratos inteligentes.

  • Objetos digitales que los jugadores realmente poseen en la cadena, creando un ecosistema abierto.

  • Generación automática de monederos para los jugadores cuando crean un nombre de usuario.

  • Sin costes de transacción ni ventanas emergentes de firma para una gran experiencia de juego y web3 UX

Construir los sistemas backend necesarios para un juego a gran escala nos habría llevado años. Pero al sustituirlos por la cadena de bloques, pudimos reducir drásticamente el tiempo de desarrollo: lanzamos Web3 Warriors en sólo 3 semanas.

Más información sobre cómo utilizamos la cadena de bloques para crear un juego a gran escala:

Presentamos a Atif Khan, VP de Gaming de thirdweb

Atif Khan, VP de Gaming en thirdweb

Acelerar el cambio transformador hacia los juegos web3 requiere un liderazgo de primer nivel y experiencia en el sector: Por eso nos complace anunciar que Atif Khan se ha unido a thirdweb como VP de Gaming.

Con más de 15 años de experiencia en la industria del gaming, Atif se une a nosotros después de pasar 8 años en Facebook - más recientemente como Jefe de Mid-Market & In-App Ads para Global Gaming - antes de entrar en el espacio de juego web3.

Queremos construir una gran y completa ventanilla única para que los desarrolladores no tengan que ir a siete u ocho sitios diferentes

- Atif Khan, Vicepresidente de juegos de thirdweb

Estamos muy contentos de que Atif lidere la tarea de llevar grandes juegos a la cadena de bloques, dando prioridad a la jugabilidad inmersiva y permitiendo a los desarrolladores incorporar potentes funciones web3 en sus juegos. Este es el primer paso hacia nuestro objetivo más amplio de crear una división de juegos de pleno derecho dentro de thirdweb.

El futuro de los juegos es web3

Mientras seguimos invirtiendo en juegos, nos entusiasma la idea de impulsar la próxima evolución de los juegos, utilizando la cadena de bloques para acelerar el desarrollo de los creadores y facilitar la propiedad digital a los jugadores.

Creo que en los próximos 18 meses empezaremos a hablar mucho menos de la perspectiva de la cadena de bloques y más de lo que la cadena de bloques está aportando realmente en términos de valor a los usuarios y desarrolladores de ambas partes.

- Atif Khan, vicepresidente de juegos de thirdweb

Si quieres saber más sobre cómo acelerar el proceso de desarrollo de juegos con la cadena de bloques, ponte en contacto con el equipo. Y si estás listo para construir, empieza con las herramientas de juego y SDK web3 de thirdweb: ¡son gratuitas!

]]> samusarmiento@newsletter.paragraph.com (thirdweb ES) thirdweb thirdweb_es gaming blockchaingaming <![CDATA[Documentación thirdweb: Infraestructura II]]> https://paragraph.com/@samusarmiento/thirdweb-storage-and-wallets g5xsoVIkbx0SDyQigP3o Fri, 09 Jun 2023 08:25:09 GMT Almacenamiento

Storage es una solución descentralizada de gestión de archivos para almacenar y recuperar información "fuera de la cadena" utilizando IPFS. Te permite subir y fijar archivos a IPFS, y recuperarlos en cualquier momento a través de nuestra pasarela IPFS.

Mediante el panel de control, el CLI o el SDK, puedes subir y anclar fácilmente archivos individuales o directorios enteros a IPFS, lo que resulta ideal para almacenar archivos de forma permanente, descentralizada y resistente a la censura.

El almacenamiento potencia la funcionalidad de varios de nuestros otros productos, como la carga de contratos inteligentes ABI en el despliegue, nuestro componente IPFS Renderer UI y las capacidades de obtención de metadatos NFT en el SDK, y la carga de metadatos NFT en el panel de control.

Pasarela IPFS

Para leer datos de IPFS, se necesita una pasarela IPFS, que te permite acceder a datos del protocolo IPFS en navegadores y otros clientes HTTP, como cuando se crea una aplicación utilizando nuestro SDK.

Te proporcionamos una pasarela IPFS pública y sin restricciones en https://ipfs.thirdwebcdn.com/ipfs/[cid], que puedes utilizar para acceder a cualquier archivo disponible en IPFS de forma gratuita, sin límites de velocidad ni restricciones.

Cómo empezar

Aprende a utilizar el almacenamiento para cargar archivos a través de la interfaz de usuario o la línea de comandos, o a utilizar el SDK para cargar archivos mediante programación.

Carga archivos directamente en IPFS mediante el panel o la CLI:

Billeteras

Wallet es una librería que te permite integrar capacidades de conexión de monederos en aplicaciones web3.

Se puede utilizar como un paquete independiente para permitir a los usuarios conectar sus carteras a tu aplicación, y se integra con nuestro SDK para utilizar la cartera conectada para interactuar con contratos inteligentes, utilizar autenticación, almacenamiento y más.

Billeteras compatibles

Accede al mayor catálogo de monederos, desde custodia a MPC y contratos inteligentes.

  • Smart Wallet: Implementa carteras de contratos inteligentes para sus usuarios

  • Local Wallet: Genera carteras para nuevos usuarios sobre la marcha

  • Safe: Conéctate a un monedero multisig a través de Safe

  • Magic Link: Conéctate con email o un número de teléfono a través de Magic

  • Paper: Conéctate con email a través de Paper

  • MetaMask: Conéctate con MetaMask

  • Coinbase Wallet: Conéctate con Coinbase Wallet

  • WalletConnect: Conéctate con AWS Key Management Service

  • AWS KMS: Conéctate con AWS Key Management Service

  • AWS Secret Manager: Conéctate con AWS Secret Manager

  • Ether.js: Conecta cualquier wallet compatible con Ether.js

  • Private Key: Conecta una wallet directamente con una clave privada

Características

Es compatible con una amplia gama de los monederos de navegador más populares como MetaMask, WalletConnect V1 y V2, Coinbase Wallet, monederos no custodiados como Magic y Paper, monederos multi-sig como Safe (Gnosis), y más; cada uno con un control detallado sobre el flujo de conexión para crear experiencias personalizadas, o componentes de interfaz de usuario pre-construidos para ponerte en marcha rápidamente.

También admite monederos inteligentes que siguen la especificación ERC-4337 y la capacidad de crear monederos locales sin transacciones que permiten a los usuarios incorporarse fácilmente a aplicaciones web3 con una experiencia de "pago de invitado".

Biblioteca de código abierto

La biblioteca de carteras es de código abierto. Puedes ver el código fuente y contribuir a ella en GitHub.

Cómo empezar

Para empezar, instale el paquete en su proyecto.

npm

npm i @thirdweb-dev/wallets

yarn

yarn add @thirdweb-dev/wallets

pnpm

pnpm add @thirdweb-dev/wallets

Ahora ya estás listo para utilizar cualquiera de nuestros monederos compatibles, solicitar al usuario que se conecte con el monedero, acceder a información como el firmante y la dirección del monedero, y mucho más.

// 1. Importa el monedero que deseas utilizar desde el paquete
import { CoinbaseWallet } from "@thirdweb-dev/wallets";

// 2. Instanciar la clase monedero
const coinbaseWallet = new CoinbaseWallet();

// 3. Conectarse al monedero (avisa al usuario cuando es necesario)
const walletAddress = await coinbaseWallet.connect();

// 4. Utiliza el monedero conectado para acceder a información como el firmante
const signer = await coinbaseWallet.getSigner();

Integraciones con nuestros SDK

Recursos adicionales

Suscríbete para recibir las guías, tutoriales y noticias de @thirdweb en español

Si tienes alguna pregunta, únete a los más de 36.000 creadores de nuestra comunidad de Discord, o ponte en contacto directamente con el equipo para obtener más información sobre cómo empezar con thirdweb.

Y si quieres empezar a construir aplicaciones web3, empieza con las herramientas web3 y SDKs de thirdweb - ¡son gratis!

]]> samusarmiento@newsletter.paragraph.com (thirdweb ES) thirdweb thirdweb_es documentacion-thirdweb <![CDATA[Documentación thirdweb: Infraestructura I ]]> https://paragraph.com/@samusarmiento/thirdweb-auth UAMO0Nr1vUo1VrtzE8ap Thu, 08 Jun 2023 13:02:57 GMT Auth

Auth es un SDK para desarrolladores que te permite integrar autenticación y autorización nativa web3 sin contraseña en tus aplicaciones.

Permite a los usuarios iniciar sesión con sus carteras, lo que permite a las aplicaciones acceder a datos enriquecidos a nivel de blockchain e interactuar con sus usuarios on-chain.

Con Auth, los desarrolladores pueden crear aplicaciones con autenticación web3-first, segura y auto custodiada.

Biblioteca de código abierto

La biblioteca auth es de código abierto. Puede ver el código fuente y contribuir a él en GitHub.

https://github.com/thirdweb-dev/js/tree/main/packages/auth

Instalación

npm

npm install @thirdweb-dev/auth

Yarn

yarn add @thirdweb-dev/auth

pnpm

pnpm add @thirdweb-dev/auth

Aplicaciones

Auth desbloquea una variedad de nuevas posibilidades al permitir la conexión de flujos web2 y web3. Añade la autenticación basada en monedero a las aplicaciones existentes o crea experiencias web3 que utilicen la arquitectura del lado del servidor.

A continuación se indican algunas de las aplicaciones que permite Auth:

  • Autenticación sin contraseña: Permite que los usuarios inicien sesión sin problemas en sus aplicaciones sólo con sus monederos.

  • Verificación de identidad: Verifica de forma segura las identidades en la cadena de los usuarios existentes.

  • Recursos bloqueados: Bloquea el acceso a recursos protegidos basándose en criterios de la cadena, como la propiedad de NFT.

  • Interacción en la cadena: Interactúa con los usuarios en la cadena, por ejemplo enviándoles NFT de recompensa.

  • Pagos on-chain: Permite a los usuarios pagar por tus servicios con activos en la cadena como ETH o tokens ERC20.

  • Acceso a datos on-chain: Acceda a datos enriquecidos en la cadena asociados a tus usuarios.

Frameworks

Auth se integra con una variedad de marcos de desarrollo, tanto del lado del servidor como del lado del cliente. Siempre estamos añadiendo soporte para más frameworks, así que si no ves el tuyo, háznoslo saber, ¡y podemos explorar la posibilidad de añadir soporte!

Frameworks de servidor

Frameworks de cliente

Integraciones

Primeros pasos con Auth

En esta guía, recorreremos el proceso de agregar Auth a una aplicación simple de pila completa para habilitar la autenticación basada en billetera (en este caso, permitiremos que las billeteras EVM se autentiquen, pero configurarlo para billeteras Solana también es una opción).

En concreto, vamos a integrar Auth con una aplicación Next.js, que tiene su propia API integrada, así como un frontend React. Con esta configuración podemos añadir puntos finales de la API de Auth a nuestra aplicación para gestionar la autenticación y autorización, y luego podemos construir un frontend simple para iniciar sesión, mostrar el usuario, y cerrar la sesión.

Si quieres ver el código completo de esta guía, usaremos el siguiente repositorio de ejemplos:

Instalación y configuración

Podemos empezar clonando el repositorio de ejemplo utilizando el comando npx thirdweb create:

npx thirdweb create --template thirdweb-auth-next

Esto utilizará el CLI de Thirdweb para clonar el repositorio de ejemplo e instalar las dependencias necesarias para nosotros de forma automática.

Una vez clonado el repositorio, tendremos que configurarlo añadiendo algunas variables de entorno. Crea un nuevo archivo .env.local en el directorio raíz del repositorio, y copia el formato del archivo .env.example. Necesitaremos añadir una clave privada y un dominio auth para nuestra API Auth.

CONSEJO

Si no quieres utilizar tu propia clave privada para este ejemplo, puede crear una nueva fácilmente ejecutando el siguiente fragmento:

const ethers = require("ethers");
console.log(ethers.Wallet.createRandom().privateKey);

.env.local

NEXT_PUBLIC_THIRDWEB_AUTH_DOMAIN=example.com # tu dominio aquí
THIRDWEB_AUTH_PRIVATE_KEY=... # tu clave privada aquí

Backend

Primero echemos un vistazo al código backend de nuestra aplicación. Si miras en la carpeta pages/api, verás dos archivos: pages/api/secret.ts y pages/api/auth/[...thirdweb].ts.

pages/api/auth/[...thirdweb].ts es donde se encuentra el núcleo de nuestra configuración de la API de autenticación, así que podemos verlo primero. En el proyecto de ejemplo, hay un poco de configuración extra que puedes explorar más adelante y que te muestra cómo utilizar algunas de las características más avanzadas de Auth, pero por ahora vamos a echar un vistazo a cómo es la configuración básica de este archivo (ten en cuenta que este fragmento de código está simplificado para excluir la configuración avanzada):

page/api/auth/[...thirdweb].ts

import { ThirdwebAuth } from "@thirdweb-dev/auth/next";
import { PrivateKeyWallet } from "@thirdweb-dev/auth/evm";

// Aquí configuramos thirdweb auth con un dominio y un monedero
export const { ThirdwebAuthHandler, getUser } = ThirdwebAuth({
  domain: process.env.NEXT_PUBLIC_THIRDWEB_AUTH_DOMAIN || "",
  wallet: new PrivateKeyWallet(process.env.THIRDWEB_AUTH_PRIVATE_KEY || ""),
});

// Utiliza ThirdwebAuthHandler como export por defecto para gestionar todas las solicitudes a /api/auth/*.
export default ThirdwebAuthHandler();

Este archivo es una ruta Next.js catch all, que capturará cualquier petición a los endpoints /api/auth/*. La función ThirdwebAuth toma la configuración de tu API Auth. Tiene muchos parámetros opcionales que no se usan aquí (puedes leer más sobre ellos en la página Auth Next.js), pero los dos parámetros obligatorios son domain y wallet.

domain se utiliza para prevenir ataques de phishing a tus usuarios - puedes aprender más sobre esto en la sección cómo funciona auth, pero lo importante es que este dominio coincida con el dominio que configuraremos más tarde en el frontend.

wallet te permite configurar el monedero de administración que emitirá y verificará los JWTs para tus usuarios. En este ejemplo, estamos usando un monedero simple de clave privada, pero también puedes usar monederos más avanzados, como se indica en la sección de configuración de monederos.

La función ThirdwebAuth nos devuelve un ThirdwebAuthHandler, que configura automáticamente varios puntos finales de autenticación para que los utilicemos para gestionar los inicios de sesión, la autenticación y los cierres de sesión (como se explica en la descripción general de la API de autenticación). También devuelve una función getUser, que podemos utilizar en otros puntos finales para autenticar al usuario que envió una solicitud.

Esto es exactamente lo que usaremos en el endpoint /api/secret, que es un endpoint simple que devuelve un mensaje secreto si el usuario está autenticado. Podemos ver que usamos la función getUser para obtener el usuario de la petición, y luego devolver el mensaje secreto si el usuario está autenticado:

pages/api/secret.ts

import { getUser } from "./auth/[...thirdweb]";
import { NextApiRequest, NextApiResponse } from "next";

const handler = async (req: NextApiRequest, res: NextApiResponse) => {
  // Obtener el usuario de la solicitud
  const user = await getUser(req);

  // Comprobar si el usuario está autentificado
  if (!user) {
    return res.status(401).json({
      message: "Not authorized.",
    });
  }

  // Devolver el mensaje secreto al usuario autenticado
  return res.status(200).json({
    message: `This is a secret for ${user.address}.`,
  });
};

export default handler;

Frontend

Ahora podemos echar un vistazo al frontend que interactúa con estos endpoints. El frontend también tiene sólo dos archivos importantes.

Primero, veamos el archivo pages/_app.tsx. Aquí queremos configurar el SDK @thirdweb-dev/react para utilizarlo con el paquete Auth. Para ello, tenemos que envolver nuestra aplicación con el componente ThirdwebProvider y añadir authConfig a la misma para que nuestro frontend sepa que tenemos una configuración Auth backend.

pages/_app.tsx

function MyApp() {
  return (
    <ThirdwebProvider
      activeChain="ethereum"
      authConfig={{
        // Este dominio debe coincidir con el backend
        domain: process.env.NEXT_PUBLIC_THIRDWEB_AUTH_DOMAIN || "",
        // Pasa la URL de los puntos finales de autenticación
        authUrl: "/api/auth",
      }}
    >
      <Component {...pageProps} />
    </ThirdwebProvider>
  );
}

Aquí, nos aseguramos de que el domain utilizado para el anti-phishing coincide con el que configuramos en nuestro backend, y también establecemos el authUrl a la URL donde configuramos nuestros puntos finales de la API Auth.

Ahora, el último paso es construir nuestro Auth UI real que nos permite conectar nuestra cartera, iniciar y cerrar sesión, lo que hacemos en el archivo pages/index.tsx:

pages/index.tsx

const Home: NextPage = () => {
  const address = useAddress();
  const connect = useMetamask();
  const { login } = useLogin();
  const { logout } = useLogout();
  const { user, isLoggedIn } = useUser();
  const [secret, setSecret] = useState();

  const getSecret = async () => {
    const res = await fetch("/api/secret");
    const data = await res.json();
    setSecret(data.message);
  };

  return (
    <div>
      {isLoggedIn ? (
        <button onClick={() => logout()}>Logout</button>
      ) : address ? (
        <button onClick={() => login()}>Login</button>
      ) : (
        <button onClick={() => connect()}>Connect</button>
      )}
      <button onClick={getSecret}>Get Secret</button>

      <pre>Connected Wallet: {address}</pre>
      <pre>User: {JSON.stringify(user, undefined, 2) || "N/A"}</pre>
      <pre>Secret: {secret || "N/A"}</pre>
    </div>
  );
};

Parece que hay varias cosas en marcha, así que vamos a dividirlo en unos pocos componentes simples:

  1. En primer lugar, añadimos la posibilidad de que los usuarios conecten sus carteras con MetaMask, e inicien sesión en nuestra aplicación utilizando los hooks useMetaMask y useLogin del paquete @thirdweb-dev/react. Usamos el hook useAddress para comprobar si el usuario está actualmente conectado con su monedero obteniendo su dirección de monedero conectado, y mostramos la dirección del monedero conectado.

  2. A continuación, usamos el hook useUser para comprobar si el usuario ha iniciado sesión en nuestro backend, y mostramos la dirección del usuario en nuestra página. También usamos el hook useLogout para que el usuario cierre la sesión en nuestro backend.

  3. Por último, utilizamos la función getSecret para realizar una petición autenticada a nuestro endpoint /api/secret, y mostramos la respuesta de la API en nuestra página.

Ejecución de la App

Ahora que hemos revisado todo el código relevante, podemos ejecutar nuestra aplicación y verla en acción, ejecutando el siguiente comando:

npm

npm run dev

Yarn

yarn dev

pnpm

pnpm run dev

Si ejecutas la aplicación y navegas a localhost:3000, o donde sea que la aplicación se esté ejecutando para ti localmente, deberías ver un simple botón de ConnectWallet. Si haces clic en él y conectas tu MetaMask, verás una pantalla como esta:

getting-started-1

Así que puedes ver que hemos conectado nuestro monedero pero no hay ningún usuario conectado. Si intentas obtener el Secret, verás que aún no estás autorizado para acceder al backend:

getting-started-2

Sin embargo, si hacemos clic en iniciar sesión y firmamos el mensaje que aparece, podremos iniciar sesión en el backend. Ahora, si hacemos clic en el botón Get Secret, podemos ver que estamos autorizados a acceder al backend:

getting-started-3

Por último, si cierras la sesión y vuelves a obtener el secret, deberías ver que ya no estás conectado.

getting-started-2

¡Llegados a este punto, hemos implementado un sistema de autenticación totalmente funcional utilizando Auth! Podemos iniciar sesión, acceder a puntos finales protegidos y cerrar sesión, al igual que un flujo de autenticación tradicional, ¡pero utilizando sólo nuestra cartera!

Guía de actualización

CONSEJO

Esta guía le ayudará a actualizar de Auth v2 a Auth v3, para personas que estaban usando @thirdweb-dev/auth@^2. Si es la primera vez que utiliza Auth, sigue los pasos previos en esta guía.

Hay algunos cambios importantes de la actualización de Auth v2 a v3. En las siguientes secciones, veremos cómo realizar las actualizaciones necesarias en el código para poder utilizar Auth v3.

React

Para actualizar, primero podemos eliminar la propiedad loginRedirect de authConfig en nuestro componente ThirdwebProvider en el nivel superior de la aplicación, ya que Auth ya no utiliza redirecciones en el inicio o cierre de sesión (de hecho, Auth nunca redirigirá a tus usuarios ahora):

import { ThirdwebProvider } from "@thirdweb-dev/react";

export default function MyApp({ Component, pageProps }) {
  return (
    <ThirdwebProvider
      // Required configuration for the provider, but doesn't affect Auth.
      activeChain="ethereum"
      authConfig={{
        domain: "example.com",
        authUrl: "/api/auth",
        // We no longer need the loginRedirect option
      }}
    >
      <Component {...pageProps} />
    </ThirdwebProvider>
  );
}

Si estás utilizando el componente de botón ConnectWallet para gestionar Auth, y no estás utilizando los hooks useLogin y useLogout, entonces este es el único cambio que tendrá que hacer. Sin embargo, si utiliza estos hooks, deberá realizar un cambio más. En Auth v2, estos hooks solían devolver sus respectivas funciones, pero en Auth v3, devuelven objetos que contienen funciones así como estados isLoading. Así que puede utilizar los nuevos ganchos desestructurándolos de la siguiente manera:

import { useLogin, useLogout } from "@thirdweb-dev/react";

export default function Component() {
  const { login, isLoading: loginIsLoading } = useLogin();
  const { logout, isLoading: logoutIsLoading } = useLogout();

  return (
    <div>
      <button onClick={login} disabled={loginIsLoading}>
        Login
      </button>
      <button onClick={logout} disabled={logoutIsLoading}>
        Logout
      </button>
    </div>
  );
}

Para una visión más completa de cómo utilizar Auth con React, consulta la guía completa Auth y React.

Next

Si utilizas Next.js como backend de Auth, también tendrás que actualizar la configuración de tu backend de Auth. El principal cambio es que Auth ya no acepta una privateKey en su configuración, y en su lugar acepta la propiedad de cartera más genérica y flexible del tipo GenericAuthWallet. Así es como puedes actualizar tu archivo pages/api/auth/[...thirdweb].ts:

import { ThirdwebAuth } from "@thirdweb-dev/auth/next";
import { PrivateKeyWallet } from "@thirdweb-dev/auth/evm";

export const { ThirdwebAuthHandler, getUser } = ThirdwebAuth({
  domain: "example.com",
  wallet: new PrivateKeyWallet(process.env.THIRDWEB_AUTH_PRIVATE_KEY || ""),
});

export default ThirdwebAuthHandler();

Este es el principal cambio que tendrás que hacer en la configuración de Auth de tu backend. Para obtener más información sobre cómo utilizar Auth con Next.js, consulta la guía completa sobre Auth y Next.

Express

Si está utilizando Express para tu backend Auth, también tendrás que actualizar la configuración de su backend Auth. Auth ya no acepta una privateKey en su configuración, y en su lugar acepta la propiedad de cartera más genérica y flexible del tipo GenericAuthWallet.

Además, la configuración de ThirdwebAuth ahora expone middleware y un enrutador para que los utilices con tus aplicaciones express para seguir un patrón más idiomático con express. Así es como puedes actualizar tu archivo pages/api/auth/[...thirdweb].ts:

import { ThirdwebAuth } from "@thirdweb-dev/auth/express";
import { PrivateKeyWallet } from "@thirdweb-dev/auth/evm";
import express from "express";

const PORT = 8000;
const app = express();

const { authRouter, authMiddleware, getUser } = ThirdwebAuth({
  domain: process.env.THIRDWEB_AUTH_DOMAIN || "",
  wallet: new PrivateKeyWallet(process.env.THIRDWEB_AUTH_PRIVATE_KEY || ""),
});

// Añade el router auth a nuestra aplicación para configurar los endpoints /auth/*.
app.use("/auth", authRouter);

// Añadir el middleware auth al resto de nuestra aplicación para permitir la autenticación de usuarios en otros puntos finales.
app.use(authMiddleware);

app.listen(PORT, () => {
  console.log(`Server listening on port ${PORT}`);
});

Con esta configuración, deberías estar listo para utilizar Auth y Express. Para obtener más información sobre cómo utilizar Auth con Express, consulta la guía completa sobre Auth y Express.

Cómo funciona Auth

En esta sección, cubriremos los fundamentos de cómo Auth habilita la autenticación y autorización nativa de web3. Empecemos repasando brevemente los conceptos básicos de autenticación y autorización.

Panorama general

¿Qué son la autenticación y la autorización?

La autenticación es el proceso de verificar la identidad de un usuario. Mientras tanto, la autorización es el proceso de verificar a qué tiene acceso un usuario específico y qué se le permite hacer.

Ser capaz de autenticar y autorizar usuarios es una parte crítica de cualquier aplicación web. Nos permite almacenar, manipular y acceder a datos específicos del usuario, y nos permite restringir el acceso a determinadas funciones en función de la identidad del usuario. Son capacidades esenciales para todas las aplicaciones, incluidas las aplicaciones web3.

¿Cómo funciona la autenticación?

Un método común de autenticación web2 implica el uso de JSON Web Tokens (JWTs) para enviar datos de autenticación entre clientes y servidores. Un flujo JWT estándar tiene el siguiente aspecto:

how-auth-works-1

Normalmente, el flujo se inicia cuando un usuario envía una solicitud para iniciar sesión en una aplicación. Esta solicitud debe contener algunos datos que demuestren al servidor que el usuario es quien dice ser, lo que llamaremos una prueba de identidad. Un ejemplo de prueba de identidad es que un usuario envíe al servidor un nombre de usuario y una contraseña.

A continuación, el servidor tiene que ser capaz de verificar esta prueba de identidad, tras lo cual puede identificar con éxito al usuario autenticado. Este proceso de verificación es lo que se conoce como autenticación. Sin embargo, sería ineficaz que los usuarios tuvieran que presentar una prueba de identidad cada vez que quisieran acceder a un recurso.

Para evitarlo, necesitamos una forma de que el servidor recuerde que un usuario ya se ha autenticado antes y, en consecuencia, recuerde la identidad de un usuario.

Esto es exactamente para lo que se utilizan los JWT. Cuando un servidor autentica con éxito a un usuario, puede emitir un JWT firmado al usuario. Este JWT contiene la identidad del usuario, que éste puede enviar al servidor en posteriores solicitudes de acceso a recursos.

Y lo que es más importante, dado que el JWT ha sido firmado por el servidor, éste puede verificar que ya ha autenticado previamente al usuario y acceder instantáneamente a su identidad sin tener que autenticarlo de nuevo.

Esta es la intuición básica detrás de cómo funcionan los flujos de autenticación JWT estándar. Auth también utiliza la autenticación JWT, pero con algunas diferencias clave que la hacen óptima para aplicaciones web3.

¿Qué hace que auth sea único?

Hay tres factores clave que diferencian a Auth y lo convierten en el flujo de autenticación web3 ideal:

  1. Auth utiliza la identidad web3

  2. Auth utiliza la prueba de identidad web3

  3. Auth utiliza la autoridad web3

Identidad

Toda aplicación necesita una forma de identificar a sus usuarios. En las aplicaciones web2 tradicionales, los usuarios suelen identificarse con un nombre de usuario o una dirección de correo electrónico únicos a los que se asocian todos los datos específicos de la aplicación.

Sin embargo, con este patrón, las identidades de usuario son siempre específicas de cada aplicación y, por tanto, sólo pueden asociarse a datos específicos de la aplicación y no son portables entre aplicaciones. Además, los usuarios tienen que crear una nueva identidad para cada nueva aplicación a la que quieran acceder. Tampoco hay una forma obvia de asociar la identidad de un usuario con sus identidades en la cadena para acceder a los datos de la cadena.

Auth resuelve todos estos problemas utilizando identidades web3. Con Auth, los usuarios se identifican con la dirección de su monedero, en lugar de con nombres de usuario o correos electrónicos. Esto significa que las identidades de los usuarios son universales en todas las aplicaciones y pueden asociarse con datos ricos a nivel de ecosistema. Además, las aplicaciones pueden utilizar las direcciones de monedero de sus usuarios para acceder a los datos de la cadena.

Prueba de identidad

Para iniciar sesión en una aplicación, los usuarios tienen que demostrar que son quienes dicen ser. En web2, esto significaba proporcionar la contraseña asociada a su nombre de usuario, para demostrar que eres el propietario del nombre de usuario. Esto obliga a los usuarios a recordar constantemente varias contraseñas en sus aplicaciones, lo que crea la necesidad de gestores de contraseñas, preguntas de seguridad y otros métodos complejos de gestión de contraseñas.

Sin embargo, en web3, los usuarios disponen de una forma mucho más sencilla de demostrar que son propietarios de una identidad concreta: las firmas digitales. Simplemente firmando un mensaje y enviándolo al servidor, los usuarios pueden demostrar que poseen una dirección de monedero específica de forma segura, sin contraseñas. El servidor puede entonces utilizar ese mensaje firmado para verificar la dirección del monedero del usuario.

Este es exactamente el patrón especificado en los estándares Sign-in with Ethereum (EIP4361) y Sign-in with Wallet (CAIP122), que son los que Auth implementa para permitir a los usuarios iniciar sesión de forma segura con sus monederos.

Así que con esta información, podemos actualizar el primer diagrama simplificado que hicimos anteriormente para aclarar cómo funciona Auth:

how-auth-works-2

Autoridad

Por último, como hemos mencionado antes, Auth utiliza JWTs para ayudar al servidor a "recordar" cuando un usuario ya se ha autenticado con éxito y ha demostrado su identidad anteriormente. Estos JWTs deben ser firmados por la autoridad del lado del servidor para que el servidor pueda verificar posteriormente que el JWT es válido.

En los flujos web2 estándar, esta emisión y verificación de tokens JWT suele estar a cargo de un servicio de terceros como auth0, que gestiona la clave privada de firma y los JWT para sus usuarios. Esto conlleva una dependencia de servicios externos de terceros para la autenticación de tus aplicaciones.

Sin embargo, Auth elimina esta dependencia de terceros utilizando web3 wallets en el backend para emitir y verificar los tokens JWT. En lugar de dejar que un servicio de terceros gestione y firme los JWT de sus usuarios, puede utilizar su propia cartera web3 como la autoridad que firma y verifica los JWT para su propia aplicación.

Esto permite un flujo de autenticación verdaderamente auto custodiado sin dependencias externas. Con esta información, ahora podemos visualizar el flujo Auth con mayor precisión:

how-auth-works-3

Conclusión

Mediante el uso de la identidad web3, la prueba de identidad y la autoridad, Auth permite un flujo de autenticación auto custodiado y nativo de web3 para sus aplicaciones que permite a los usuarios iniciar sesión con sus carteras.

Esto nos permite acceder de forma segura a la identidad en cadena de los usuarios en el lado del servidor, desbloqueando la conexión entre las experiencias web2 y web3.

Auth API

Así que ahora que entendemos cómo funciona Auth y los detalles de los bloques de construcción que lo hacen posible, vamos a poner toda esa información junta para entender lo específico de cómo funciona la API de Auth.

La API de Auth es un conjunto de puntos finales REST que implementan todos los complementos de servidor del SDK de autenticación. Permiten la autenticación y autorización basadas en monedero para cualquier API a la que se añadan. La Auth API ofrece tres puntos finales clave:

  • POST - /login

  • GET - /user

  • POST - /logout

Veamos con más detalle cómo es cada uno de estos puntos finales y cómo funcionan todos juntos.

Login

auth-api-1

El endpoint /login es el inicio de todo el flujo Auth. Es un punto final POST que espera recibir el payload de inicio de sesión con monedero del cliente. El propósito principal de este endpoint es comprobar que el usuario ha realizado una petición válida de inicio de sesión con monedero, y emitirle un JWT firmado si lo tiene para que se autentique en otros endpoints.

El endpoint /login realiza los siguientes pasos para lograr esto:

  1. Comprueba que la solicitud de inicio de sesión con monedero es válida, segura y no ha caducado, como se especifica en la sección de inicio de sesión con monedero.

  2. Generar un JWT firmado para que el usuario se autentique en otros puntos finales, como se especifica en la sección JWT.

  3. Devuelve el JWT firmado al cliente tanto en la respuesta como en las cookies, para compatibilidad entre clientes con y sin navegador.

User

auth-api-2

El punto final /user es un punto final GET que permite al cliente comprobar periódicamente si el usuario sigue conectado y obtener cualquier dato de usuario asociado que sea relevante para el cliente (como datos de perfil, por ejemplo).

Esto se puede lograr siguiendo los siguientes pasos:

  1. Comprobar que el usuario ha enviado un JWT válido en las cookies o cabeceras de la petición, como se especifica en la sección JWT.

  2. Si el usuario no ha enviado un JWT válido, devolver null.

  3. Rellenar cualquier dato de sesión almacenado en el JWT en el objeto de usuario y cualquier dato externo asociado al usuario en el objeto de usuario (como datos de una base de datos).

  4. Devuelve el objeto de usuario al cliente

Logout

auth-api-3

El endpoint /logout es el más simple de todos. Su objetivo es simplemente invalidar el JWT del usuario y cerrar su sesión en la aplicación. Esto se consigue borrando cualquier cookie del cliente con el JWT, y opcionalmente invalidando el JWT si se utiliza una base de datos.

Endpoints protegidos

auth-api-4

Por último, podemos echar un vistazo a cómo Auth se puede utilizar para proteger puntos finales adicionales, que es una de sus funciones más importantes, ya que esto comprende su función de autorización.

Autorizar al usuario en un endpoint implica el siguiente proceso simple:

  1. Obtener la identidad del usuario autenticado mediante un método similar al del endpoint /user (es decir, leyéndola del JWT, si hay alguno presente).

  2. Conceder permiso al usuario basándose en su identidad

En todos los plugins de autenticación, esto se gestiona mediante una sencilla función de ayuda que puedes añadir a tus endpoints para no tener que preocuparte de los detalles del proceso.

Sign-in with Wallet

JSON Web Tokens

Configuración de Wallet

Auth hace uso de un monedero del lado del servidor para firmar y verificar JWTs, como se explica en la sección cómo funciona auth. Puedes configurar este monedero usando una variedad de opciones de gestión de monederos, dándote la libertad de elegir la configuración más conveniente y segura para tu proyecto.

Recursos adicionales

Suscríbete para recibir las guías, tutoriales y noticias de @thirdweb en español

Si tienes alguna pregunta, únete a los más de 36.000 creadores de nuestra comunidad de Discord, o ponte en contacto directamente con el equipo para obtener más información sobre cómo empezar con thirdweb.

Y si quieres empezar a construir aplicaciones web3, empieza con las herramientas web3 y SDKs de thirdweb - ¡son gratis!

]]> samusarmiento@newsletter.paragraph.com (thirdweb ES) thirdweb thirdweb_es documentacion-thirdweb <![CDATA[Documentación thirdweb: CLI, Deploy & Publish]]> https://paragraph.com/@samusarmiento/thirdweb-cli-deploy-publish Yk9biOPNPAUOme0JI7WC Wed, 07 Jun 2023 15:28:58 GMT CLI

Visión General

El CLI proporciona herramientas para crear, construir y desplegar proyectos utilizando herramientas e infraestructura de thirdweb. Mediante el CLI, puedes crear nuevos proyectos con el SDK configurado, construir, publicar y desplegar contratos inteligentes, generar tipos mientras desarrollas, subir archivos a IPFS, etc.

Instalación

Instala el paquete CLI globalmente para utilizar los comandos en cualquier parte del sistema.

Nota: Si no desea instalarlo globalmente, puede anteponer cada comando con npx. es decir, npx thirdweb <command>.

npm i -g @thirdweb-dev cli
yarn global add @thirdweb-dev cli
pnpm install -g @thirdweb-dev cli

Una vez instalado, puede ver la lista completa de comandos disponibles ejecutando:

thirdweb

Comandos disponibles

  • create : Crea una aplicación web3 a partir de cualquiera de nuestras plantillas oficiales.

  • install : Añade los paquetes de thirdweb a tu proyecto existente.

  • build : Compilar contract y detectar las extensiones contract de thirdweb.

  • generate : Fetch contract ABIs para generar tipos y mejorar el rendimiento en el SDK.

  • upload : Subir cualquier archivo o directorio al almacenamiento descentralizado (IPFS).

  • deploy : Despliega tus contratos (o los de tu equipo) de forma segura en blockchains.

  • publish : Publica tu protocolo para que otros desarrolladores puedan desplegarlos y desbloquear SDKs, cuadros de mando y análisis.

Deploy

Despliega fácilmente cualquier contrato en cualquier cadena compatible con EVM, utilizando un único comando:

npx thirdweb deploy

Sin configuración, claves privadas codificadas, URL RPC ni scripts.

¿Por qué usar Deploy?

Ventajas de utilizar Deploy:

  • No necesita configuración ni instalación.

  • Mayor seguridad:

    • No es necesario exportar una clave privada. El despliegue se realiza desde la interfaz de usuario del panel de control desde el navegador, utilizando un monedero de navegador.

    • Compatibilidad con Safe, por lo que no es necesario compartir claves privadas con el equipo.

  • No es necesario configurar una URL RPC: ¡nosotros nos encargamos de todas las complejidades por ti!

  • Despliega utilizando una interfaz de usuario. Esto te permite establecer los argumentos del constructor en el momento del despliegue.

  • Carga y fija automáticamente los metadatos del contrato en IPFS.

  • Verifica automáticamente tu contrato en Sourcify.

  • Añade automáticamente el contrato al panel de control: ¡este paso no tiene gas! Esto significa que puedes gestionar e interactuar fácilmente con tu contrato.

  • No es necesario copiar la ABI del contrato al integrar su contrato inteligente en una aplicación web3.

¿Cómo funciona?

Al utilizar Deploy, los metadatos de tu contrato se cargan automáticamente en IPFS y se verifican, haciendo que tu contrato se pueda utilizar en cualquier aplicación web3 sin tener que copiar tu ABI de contrato.

Esto funciona:

  1. Usando el comportamiento por defecto de solc (el compilador de solidity) - añadiendo los metadatos codificados del contrato al bytecode del contrato.

  2. Subiendo los metadatos de los contratos a IPFS.

Codificación y extracción de los metadatos contractuales

Por defecto, al compilar cualquier contrato solidity, el compilador solc:

  1. Calcula el hash IPFS del artefacto JSON de metadatos del contrato (que contiene información como el nombre del contrato, ABI, código fuente, comentarios y configuración del compilador).

  2. Codifica el hash IPFS calculado utilizando la codificación CBOR.

  3. Añade los bytes codificados al final del código de bytes compilado.

Esto significa que desde cualquier contrato desplegado, puedes

  1. Obtener el bytecode del contrato utilizando la llamada RPC estándar eth_getCode.

  2. Decodificar los datos al final del bytecode utilizando un decodificador CBOR.

  3. Extraer el hash IPFS de los datos decodificados.

  4. Descargar los metadatos originales del contrato, que contienen el código fuente, la ABI, etc.

Dado que los hashes IPFS son inmutables, se garantiza que los metadatos codificados del contrato son correctos y no han sido modificados. Esto significa que todos los contratos son autoverificables por diseño y sin necesidad de terceros. Sin embargo, el compilador sólo calcula el hash IPFS y lo codifica, ¡no carga nada en IPFS!

Cargar metadatos de contratos en IPFS

Al utilizar Deploy:

  1. Los metadatos de tu contrato se suben automáticamente a IPFS, lo que significa que podemos hacer uso del comportamiento por defecto de solc para desbloquear nuestros SDKs.

  2. Su contrato se verifica automáticamente en Sourcify.

Esto facilita la creación de aplicaciones web3, utilizando nuestros SDKs, sin tener que copiar o actualizar la ABI del contrato. En su lugar, el ABI se recupera de los metadatos del contrato cargados en IPFS. Esto actúa como una fuente de verdad y, por lo tanto, siempre está actualizado.

Deploy: Primeros pasos

Utiliza el CLI para desplegar tus contratos directamente en cualquier cadena compatible con EVM utilizando el panel de control.

npx thirdweb deploy

Uso

Ejecutando este comando podrás:

  • Detectar el framework (Hardhat, Foundry o Truffle).

  • Compilar todos los contratos en el directorio actual utilizando la configuración del proyecto.

  • Seleccionar qué contrato(s) desea desplegar.

  • Cargar los metadatos de tu contrato en IPFS, asegurándote de que coinciden exactamente con el hash IPFS codificado en el bytecode compilado.

  • Detectar las extensiones de tu contrato.

  • Abrir el flujo de despliegue en el panel de control para que conectes un monedero, introduzcas los parámetros del contrato y selecciones una cadena en la que desplegarlo, ¡sin necesidad de codificar las claves privadas!

npx thirdweb [options]

Options

-p--path <string>

Trayectoria del proyecto

-c--clean

Borrar la memoria caché antes de construir

--dry-run

Ejecución en seco (sin publicar)

-d--debug

Mostrar registros de depuración

--ci

Integración continua

--dist-path <string>

Ruta a la carpeta dist donde se encuentra la aplicación basada en HTML

-n--name <string>

Nombre del contrato preconstruido o publicado (como nft-drop)

-f--file <string>

Filtro de expedientes de contrato que contienen este nombre de expediente

-cn--contract-name <string

Filtro de contratos que contienen este nombre de contrato

-cv--contract-version <string>

Versión del contrato publicada

--app

Despliegue de una aplicación web en un almacenamiento descentralizado

--contract

Desplegar un contrato inteligente en la blockchain

--dynamic

Despliegue de un contrato inteligente dinámico compuesto por extensiones de blockchain

Publish

Publica cualquier contrato utilizando el siguiente comando:

npx thirdweb publish

Introducción

Publicar tu contrato es la mejor manera de compartirlo con el mundo. Cuando publicas tu contrato, se vuelve compartible, verificable y desplegable por cualquiera.

¿Por qué publicar tu contrato?

  • Los contratos publicados pueden desplegarse en cualquier red EVM cuando se utiliza la fábrica predeterminada.

  • Cuando se despliega un contrato publicado, se obtienen SDK y cuadros de mando autogenerados que permiten gestionar el contrato y ayudan a crear fácilmente aplicaciones sobre él.

  • Todos los contratos publicados tienen una página de inicio. Esto permite a otros explorar las funciones y eventos de su contrato, y ver el código fuente.

  • El registro de contratos publicados es totalmente on-chain. Puedes construir tu reputación on-chain como desarrollador de contratos inteligentes.

  • Los mejores contratos publicados aparecen en la página Explorer, que es vista por más de 70.000 desarrolladores web3.

Publicar tu contrato es completamente gratis, nosotros cubrimos todos los gastos de gas.

Cómo publicar

Utiliza el CLI para publicar tus contratos directamente en cualquier cadena compatible con EVM mediante el panel de control:

npx thirdweb publish

Este comando:

  • Compila tu contrato inteligente.

  • Sube el código fuente del contrato (ABI) a IPFS.

  • Abre el flujo de publicación en el panel de control.

Options

-p--path <string>

Trayectoria del proyecto

-f--file <string>

Filtro de expedientes de contrato que contienen este nombre de expediente

-cn--contract-name <string>

Filtro de contratos que contienen este nombre de contrato

-c--clean

Borrar la memoria caché antes de construir

--dry-run

Ejecución en seco (sin publicar)

-d--debug

Mostrar registros de depuración

--ci

Modo de integración continua

Cómo publicar tu contrato

En tu navegador, sigue los pasos que se indican a continuación para publicar tu contrato:

Configurar los metadatos del contrato

Desde el panel de control, proporciona los metadatos para el contrato inteligente, incluyendo:

  • Name

  • Image

  • Description

  • README - Markdown es compatible. Qué hace tu contrato, casos de uso común y ejemplos son grandes cosas para incluir aquí.

Añadir una versión e informe de auditoría (opcional)

Utiliza el versionado semántico para publicar de forma incremental nuevas versiones de tu contrato inteligente; ideal para cuando quieres hacer cambios en tu contrato inteligente pero no quieres romper las integraciones existentes.

Cada versión de tu contrato inteligente se almacena en la cadena y puede ser desplegada por cualquiera. Opcionalmente puedes incluir notas de la versión, para describir los cambios que has hecho entre versiones.

También puedes vincular cada versión a un informe de auditoría. Puedes pegar un enlace o arrastrar y soltar un PDF. Nosotros generaremos un enlace IPFS para ti.

Versioned Releases

Elige cómo los usuarios desplegarán el contrato publicado

Seleccione el tipo de contrato para tu contrato publicado

  • Despliegue directo: Elige esta opción si tu contrato no sigue el patrón de contrato actualizable.

    • Esta opción puede utilizarse para cualquier contrato.

    • No hay requisitos para utilizar esta opción para publicar el contrato.

    • Los usuarios desplegarán el contrato completo: almacenamiento y lógica de implementación.

  • Desplegar vía Fábrica: Elige esta opción si deseas que los usuarios desplieguen proxies de tu contrato utilizando el contrato de fábrica predeterminado de thirdweb o utilizando su propia fábrica personalizada predesplegada.

    • Fábrica predeterminada: utiliza esta opción para utilizar la fábrica predeterminada de thirdweb si tu contrato sigue el patrón de contratos actualizables.

    • Fábrica personalizada - Utiliza esta opción para utilizar su propia fábrica personalizada predesplegada para crear proxies para sus usuarios.

Choose Contract Type

Una vez seleccionado, haz clic en "Next" para pasar al tipo de contrato seleccionado.

Elija en qué red(es) publicar su contrato

Selecciona la(s) red(es) en la(s) que deseas publicar su contrato. Puedea seleccionar varias redes o cualquier EVM.

Choose Network

Si eliges publicar mediante despliegue directo, se te pedirá que selecciones la(s) red(es) en la(s) que deseas que los usuarios puedan desplegar tu contrato, a continuación, ha< clic en el botón "Next". Si opta por la publicación en fábrica, se te pedirá que seleccione la red o redes en las que desea que los usuarios puedan desplegar tu contrato cuando configures los "Ajustes de despliegue en fábrica".

Personalizar los parámetros del contrato

Ayuda a los usuarios que intentan desplegar tu contrato inteligente cambiando el aspecto de los parámetros de tu contrato. Se trata de campos que los usuarios deben introducir antes de desplegar el contrato. Cada campo corresponde a la variable asociada en el constructor del contrato.

  • Display name: Utilízalo para tener una versión más legible del nombre del parámetro. De lo contrario, el nombre del parámetro del contrato se mostrará tal cual.

  • Default value: Se rellenará previamente en el formulario de despliegue. Utilízalo para orientar a los usuarios sobre el valor que deben introducir. Si el parámetro es del tipo de datos, puede rellenar previamente la dirección de la cartera conectada del usuario estableciendo el valor predeterminado como {{connected_wallet}}.

  • Description: Utiliza esta opción para aclarar cualquier confusión y explicar qué valor se espera de este parámetro.

  • Advanced: Marque esta opción si deseas ocultar este parámetro del formulario de despliegue. Esto es útil para parámetros que no requieren ser cambiados por el usuario. Esta opción sólo está disponible para parámetros que tienen un valor por defecto.

Describe Constructor Parameters

Publicar contrato

Por último, haz clic en el botón "Publish Contract" para publicar tu contrato inteligente en el registro de la cadena.

Para conocer las mejores prácticas y publicar tu contrato en Explore:

Cómo ser destacado

Poner tu contrato en la página Explore es la mejor manera de ponerlo delante de los desarrolladores de web3. Más de 70.000 constructores de web3 visitan esta página.

¿Quieres que tu contrato aparezca en la página Explore? Solicítalo aquí

Mejores prácticas

Los contratos publicados que siguen estas directrices tienen más posibilidades de aparecer en la página Explore. Esto mejora la experiencia de las personas que despliegan su contrato publicado.

  • El nombre y la descripción del contrato deben ser claros y concisos.

  • Añade una imagen a tu contrato.

  • Publica tu contrato desde tu cuenta pública, preferiblemente una que esté vinculada a un ENS. Actualiza el nombre, la descripción y la imagen de tu cuenta.

  • Redacte un README completo que informe a los usuarios de lo que hace tu contrato, cómo funciona y cómo desplegarlo.

  • Añade nombres para mostrar, valores por defecto y descripciones para los parámetros de tu contrato. Esto facilita a los usuarios el despliegue del contrato.

  • En el caso de contratos proxy y de fábrica, haz que esté disponible en tantas redes como sea posible.

  • Enlace al informe de auditoría de su contrato. Los contratos auditados tienen más posibilidades de ser destacados.

Si tiene alguna pregunta o necesitas ayuda para publicar tu contrato, contacta con nosotros. Nuestro equipo estará encantado de ayudarle.

Recursos adicionales

Si tienes alguna pregunta, únete a los más de 36.000 creadores de nuestra comunidad de Discord, o ponte en contacto directamente con el equipo para obtener más información sobre cómo empezar con thirdweb.

Y si quieres empezar a construir aplicaciones web3, empieza con las herramientas web3 y SDKs de thirdweb - ¡son gratis!

]]> samusarmiento@newsletter.paragraph.com (thirdweb ES) thirdweb thirdweb_es documentacion-thirdweb <![CDATA[Documentación thirdweb: EVM SDK]]> https://paragraph.com/@samusarmiento/thirdweb-evm-sdk w4EFD6mJOnupUuz2Wff6 Wed, 07 Jun 2023 10:27:23 GMT EVM SDK

Visión general

El SDK cubre todos los aspectos de la pila de desarrollo web3, incluyendo la conexión a los monederos de los usuarios, la interacción con la blockchain y los contratos inteligentes, el almacenamiento descentralizado, la autenticación, y más; lo que nos permite construir aplicaciones web3 escalables y de alto rendimiento en cualquier blockchain compatible con EVM.

Se proporciona infraestructura para lo necesario para crear aplicaciones descentralizadas, incluida la conexión a la cadena de bloques (RPC), el almacenamiento descentralizado (IPFS + servicios de fijación) y herramientas para crear potentes experiencias de usuario, como transacciones sin gas, componentes de conexión de monederos, rampas de acceso FIAT, API de datos y mucho más.

El SDK es totalmente componible, lo que significa que puedes proporcionar tu propia configuración para cualquier componente de tu aplicación y personalizar el SDK según tus necesidades. Además, cada SDK es completamente de código abierto para que puedas verificar y auditar lo que ocurre bajo el capó.

Dependiendo del caso de uso, admitimos una gran variedad de lenguajes y marcos de trabajo para ayudarte a crear tus aplicaciones y juegos.

En las siguientes guías estaremos profundizando en los lenguajes y frameworks con los que trabajamos desde thirdweb. ¡Suscríbete para no perderte nada!

Arquitectura del SDK

El SDK cubre todo el espectro del desarrollo de aplicaciones descentralizadas, desde la conexión a la cadena de bloques hasta la interfaz de usuario. Para permitir la personalización y la flexibilidad, el SDK está diseñado para ser modular y componible, lo que te permite proporcionar cualquier configuración personalizada o integraciones con otros servicios y herramientas para reemplazar o mejorar la funcionalidad predeterminada.

Marco basado en contratos

Al utilizar el SDK para interactuar con contratos inteligentes, el SDK utiliza un marco basado en contratos, lo que significa que el SDK detecta estándares y patrones comunes como ERC20, ERC721, ERC1155, permisos, etc., resolviendo la ABI del contrato inteligente y extrayendo los estándares que implementa el contrato, conocidos como extensiones.

Cada extensión detectada desbloquea funcionalidades en el SDK para que las puedas utilizar; permitiendo conjuntos de métodos y componentes para ser utilizados en el lenguaje de tu elección para interactuar directamente con el contrato inteligente.

Nuestro ecosistema de herramientas, como el panel de control y la función de importación, hacen que el uso de contratos inteligentes sea más sencillo y eficiente. Conectarse a un contrato inteligente sólo requiere la dirección del contrato, (sin ABI), y se resuelven desde nuestro registro en la cadena de contratos inteligentes de forma automática. El SDK almacena automáticamente en caché la información de cada contrato, por lo que las operaciones de lectura y escritura de datos en el contrato inteligente son rápidas y eficientes.

Pilas incluidas

Fuera de la caja, la infraestructura para alimentar los componentes esenciales de las aplicaciones descentralizadas se incluye en el SDK. La conexión a la cadena de bloques a través de RPC, el servicio de anclaje IPFS y las pasarelas, el elegante flujo de incorporación de monederos, las rampas de entrada FIAT y mucho más están preconfigurados por defecto, con una fácil configuración para adaptarlos a tus necesidades.

Todas nuestras ofertas funcionan juntas a la perfección, lo que te permiten crear aplicaciones descentralizadas de alto rendimiento sin sacrificar tu experiencia como desarrollador.

Sin dependencia del proveedor

Todos los aspectos del SDK son modulares y componibles, lo que te permite personalizar cualquier parte de nuestras herramientas según tus necesidades o integrarlas con otros servicios para casos de uso específicos. Si deseas proporcionar tu propio RPC, utilizar un flujo de conexión de monedero diferente, proporcionar tu propia solución de almacenamiento descentralizado o utilizar un relé sin gas diferente, puede hacerlo con facilidad.

Recursos adicionales

Si tienes alguna pregunta, únete a los más de 36.000 creadores de nuestra comunidad de Discord, o ponte en contacto directamente con el equipo para obtener más información sobre cómo empezar con thirdweb.

Y si quieres empezar a construir aplicaciones web3, empieza con las herramientas web3 y SDKs de thirdweb - ¡son gratis!

]]> samusarmiento@newsletter.paragraph.com (thirdweb ES) thirdweb thirdweb_es documentacion-thirdweb <![CDATA[Documentación thirdweb: Solidity SDK]]> https://paragraph.com/@samusarmiento/thirdweb-solidity-sdk gfZ9B2f83Nu7zceljRVJ Tue, 06 Jun 2023 12:13:54 GMT thirdweb Solidity SDK

Visión general

thirdweb Solidity SDK proporciona las herramientas necesarias para construir contratos inteligentes personalizados de manera eficiente, ofreciendo un conjunto de contratos base pre-construidos y un conjunto de componentes reutilizables, o extensiones, que se pueden integrar en sus propios contratos inteligentes.

Contratos base

Los contratos base son contratos inteligentes prediseñados sobre los que se puede construir o modificar, como el contrato ERC721Base. Estos contratos funcionan de forma inmediata y no requieren la implementación de ninguna función. Se construyen utilizando extensiones y, por lo tanto, desbloquean funciones inteligentes en los SDK y secciones personalizadas en el Dashboard para interactuar fácilmente con tu contrato inteligente.

Extensiones

Las extensiones son interfaces de Solidity que son reconocibles por el Dashboard y desbloquean la funcionalidad en los SDK. Las EIPs comunes también son reconocibles como extensiones ya que nuestras interfaces se ajustan a los estándares de la industria. Son piezas componibles de lógica que pueden añadirse fácilmente a los contratos inteligentes a través de la herencia.

Estas extensiones requieren distintos niveles de implementación lógica* en el contrato inteligente heredado. Los tres tipos diferentes de extensiones en este SDK son:

  • Contratos de extensión: Estas extensiones son totalmente completas y no requieren la implementación de ninguna lógica. Al heredar de estos contratos, se añade la funcionalidad y, por tanto, la lógica al contrato inteligente heredado.

  • Contratos abstractos: Estas extensiones requieren que se implemente parte de la lógica. Algunas de las funciones de la extensión dependen del caso de uso y, por lo tanto, requieren una lógica personalizada que es específica de tu contrato inteligente heredado.

  • Interfaces: Estas extensiones no tienen una implementación. Proporcionan las directrices para escribir tu propia lógica dándote las funciones, parámetros y tipos de retorno. Esto te permite asegurarte de que tu contrato se ajusta a esta extensión concreta para que puedas desbloquear funciones en los SDK y el Dashboard.

*implementar = escribir la lógica de la función con una firma de función coincidente (nombre, parámetros, visibilidad y tipo de retorno coincidentes).

Extensions

¿Por qué utilizar el SDK de Solidity?

  • Integra sin esfuerzo características comunes de contratos inteligentes, incluyendo EIPs populares como ERC20, ERC721, ERC1155, permissions, contract metadata y más.

  • Simplifica el flujo de trabajo de desarrollo, permitiéndote centrarse en sistemas más intrincados.

  • El uso de los contratos base le proporciona una base optimizada y auditada para construir sus proyectos.

  • Cada extensión que hereda desbloquea SDKs más inteligentes, Dashboards personalizados y feeds de datos a medida.

Por ejemplo, si despliega el contrato ERC721Base, que hereda de múltiples extensiones, incluida ERC721Mintable, desbloqueará el botón mint en el panel de control y podrá utilizar la función mint en el SDK, que carga y fija automáticamente sus metadatos en IPFS.

Primeros pasos

Para empezar a utilizar Solidity SDK, ejecuta el siguiente comando para crear un nuevo proyecto:

npx thirdweb create contract

O bien, instala el paquete de contracts en tu proyecto Solidity existente

Hardhat 

npm install @thirdweb-dev contracts

Forge

forge install thirdweb-dev contracts

Uso del SDK de Solidity

El SDK de Solidity puede utilizarse para construir nuevos contratos inteligentes de extremo a extremo, o para añadir funcionalidad a tu propio contrato inteligente existente utilizando extensiones. Todas las funciones de los contratos base y las extensiones pueden modificarse sobrescribiéndolas.

Uso de contratos base

El SDK de Solidity incluye contratos base que son contratos inteligentes totalmente completos que pueden personalizarse sobrescribiendo funciones O añadiendo extensiones.

  1. Para empezar, importa y hereda el contrato base. Puedea encontrar la lista de todos los contratos base disponibles aquí.

  2. Los contratos base esperan que ciertos argumentos del constructor funcionen según lo previsto. Implementa un constructor para tu contrato inteligente y pasa los valores apropiados a un constructor para el contrato base.

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

import "@thirdweb-dev/contracts/base/ERC721Base.sol";

contract MyNFT is ERC721Base {
    constructor(
        string memory _name,
        string memory _symbol,
        address _royaltyRecipient,
        uint128 _royaltyBps
    ) ERC721Base(_name, _symbol, _royaltyRecipient, _royaltyBps) {}
}

  1. ¡Ahora ya está todo listo! 🎉 Tu contrato inteligente tiene ahora todas las extensiones proporcionadas por el contrato base que hereda y está listo para ser desplegado en cualquier blockchain EVM de tu elección.

Uso de Extensiones

Las extensiones deben utilizarse mediante herencia - el contrato inteligente de tu proyecto heredará de ellas.

Extensiones adicionales pueden ser añadidas a contratos inteligentes existentes o a los contratos base para añadir funcionalidad extra y desbloquear características en los SDKs y Dashboard.

  1. Para empezar, importa y hereda la extensión. Puede encontrar la lista de todas las extensiones disponibles aquí.

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

import "@thirdweb-dev/contracts/base/ERC721Base.sol";
import "@thirdweb-dev/contracts/extension/Permissions.sol";

contract MyNFT is ERC721Base, Permissions {
    constructor(
        string memory _name,
        string memory _symbol,
        address _royaltyRecipient,
        uint128 _royaltyBps
    ) ERC721Base(_name, _symbol, _royaltyRecipient, _royaltyBps) {}
}

Nota:

  • Algunas extensiones son abstractas y requieren la implementación de determinadas funciones*.

  • Algunas Extensiones son Interfaces y requieren que todas las funciones sean implementadas*.

*implementar = escribir la lógica de la función con una firma de función coincidente (nombre, parámetros, visibilidad y tipo de retorno coincidentes).

  1. Utiliza las funciones proporcionadas por la Extensión para cambiar el comportamiento de tu contrato inteligente.

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

import "@thirdweb-dev/contracts/base/ERC721Base.sol";
import "@thirdweb-dev/contracts/extension/Permissions.sol";

contract MyNFT is ERC721Base, Permissions {
    bytes32 private constant MINTER_ROLE = keccak256("MINTER_ROLE");

    constructor(
        string memory _name,
        string memory _symbol,
        address _royaltyRecipient,
        uint128 _royaltyBps
    ) ERC721Base(_name, _symbol, _royaltyRecipient, _royaltyBps) {}

    /**
     * `_canMint` es una función disponible en `ERC721Base`.
     *
     * Es llamada cada vez que un monedero intenta acuñar NFTs en este contrato.
     * contrato, y le permite definir la condición en la que un
     * intento de acuñar NFTs debe ser permitido, o rechazado.
     *
     * Por defecto, `ERC721Base` sólo permite al propietario del contrato acuñar
     * NFTs. Aquí anulamos esta funcionalidad.
     *
     * Usamos la extensión `Permissions` para especificar que cualquiera que tenga
     * "MINTER_ROLE" pueda acuñar NFTs.
     */
    function _canMint() internal view override returns (bool) {
        return hasRole(MINTER_ROLE, msg.sender);
    }
}

Herencia y sustitución de funciones

La herencia te permite extender las propiedades de tu contrato inteligente para incluir los atributos y propiedades del contrato padre. Las funciones heredadas de este contrato padre pueden ser modificadas en el contrato hijo a través de un proceso conocido como overriding.

Contrato padre: Contrato del que hereda el contrato hijo.

Contrato hijo: El contrato heredado.

Para sobreescribir una función, para añadir tu propia lógica personalizada, simplemente utiliza la palabra clave override al declarar la función, asegurándote de que la firma de la función coincide. Para añadir la lógica original del contrato padre, utilice la palabra clave super.

Por ejemplo, el contrato ERC721Base tiene una implementación de la función mintTo, yo podría sustituir esta función para añadir lógica personalizada y restringir esta función en el contrato myNFT para permitir sólo 1 NFT por monedero:

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

import "@thirdweb-dev/contracts/base/ERC721Base.sol";
import "@thirdweb-dev/contracts/extension/Permissions.sol";

contract MyNFT is ERC721Base, Permissions {
    constructor(
        string memory _name,
        string memory _symbol,
        address _royaltyRecipient,
        uint128 _royaltyBps
    ) ERC721Base(_name, _symbol, _royaltyRecipient, _royaltyBps) {}

    function mintTo(address _to, string memory _tokenURI) public override {
        require(balanceOf(_to) < 1, "only 1 NFT per wallet!");
        super.mintTo(_to, _tokenURI);
    }
}

Contratos Base

Listado de contratos base

Extensiones

Listado de extensiones

Referencia completa

Instalación

npm i @thirdweb-dev contracts

Testeando​

  1. yarn: instalar dependencias de contratos

  2. forge install: instalar dependencias de pruebas

  3. forge test: ejecutar las pruebas

Este repositorio es un proyecto híbrido de hardhat y forge.

Primero instala las dependencias relevantes del proyecto:

yarn

forge install

Para compilar contratos, ejecuta:

forge build

O, si prefieres hardhat, puedes correr:

npx hardhat compile

Para realizar pruebas:

forge test

Para exportar los ABI de los contratos del directorio contracts ejecuta:

npx hardhat export-abi

Para ejecutar cualquier script del directorio scripts ejecuta:

npx hardhat run scripts/{ruta al script}

Contratos Pre-construidos

Los contratos pre-construidos están escritos por el equipo de thirdweb y cubren los casos de uso más comunes para los contratos inteligentes.

Páginas de publicación de los contratos preconstruidos:

Despliegues

El registro thirdweb (TWRegistry) y la factory (TWFactory) se han desplegado en las siguientes cadenas:

TWRegistry está desplegado en una dirección común en todas las redes mencionadas. TWFactory está desplegado en una dirección común en todas las redes mencionadas excepto Fantom mainnet.

Autores​

License​

Apache 2.0

Recursos adicionales

Si tienes alguna pregunta, únete a los más de 36.000 creadores de nuestra comunidad de Discord, o ponte en contacto directamente con el equipo para obtener más información sobre cómo empezar con thirdweb.

Y si quieres empezar a construir aplicaciones web3, empieza con las herramientas web3 y SDKs de thirdweb - ¡son gratis!

]]> samusarmiento@newsletter.paragraph.com (thirdweb ES) thirdweb thirdweb_es documentacion-thirdweb <![CDATA[Documentación thirdweb: Cómo empezar]]> https://paragraph.com/@samusarmiento/thirdweb-como-empezar kbtb5khe9WF0N8dXBl91 Mon, 05 Jun 2023 16:12:47 GMT Introducción

En esta guía de inicio, te mostraremos cómo construir y desplegar una aplicación web3 completa. Aprenderás a:

  • Crear y desplegar un contrato inteligente

  • Gestionar tu contrato desde el panel de control

  • Construir una aplicación React utilizando el SDK para interactuar con el contrato

Si eres de los que aprendes mejor visualmente te dejo el canal de Youtube de mis compañeros de thirdweb https: www.youtube.com @thirdweb_/videos y en concreto este de Jarrot Wats, Developer experience engineer de thirdweb:

Suscríbete al canal en español si quieres que subamos todo el contenido en video en español

https: www.youtube.com @thirdwebes

Antes de empezar

Te recomendamos que tengas instaladas las siguientes herramientas antes de empezar:

  • Node.js y npm: Para instalar nuestro SDK en tu proyecto.

  • Yarn: Para ejecutar scripts en nuestra app React.

  • Git: Para usar el comando create en nuestra CLI.

Despliega un contrato inteligente

Es posible que quieras crear un contrato inteligente desde cero o desplegar uno prediseñado que satisfaga tus necesidades; ofrecemos soluciones para crear y desplegar cualquier contrato inteligente.

Explore

Contratos seguros, optimizados para el gas y auditados, listos para desplegarse con un solo clic.

Desde la página Explore, puedes elegir entre una colección curada de contratos inteligentes optimizados para gas, auditados y probados, construidos por protocolos de código abierto de confianza y por el equipo de thirdweb; listos para desplegar en un clic.

Por ejemplo, seleccionemos el contrato inteligente NFT Collection creado por el equipo de thirdweb:

Desde esta página, podemos descubrir las características del contrato, ver su código fuente, ver qué extensiones implementa y desplegarlo en la blockchain de nuestra elección.

Haz clic en el botón "Deploy Now" para entrar en el flujo de despliegue, e introduce los metadatos de tu contrato inteligente; como su nombre, símbolo, imagen y descripción:

Por último, seleccione la red en la que quieres desplegar el contrato inteligente y haz clic en "Deploy Now"

Una vez desplegado tu contrato, se te redirigirá al panel de control de tu contrato.

Construye tu propio SmartContract

Crea contratos personalizados específicos para su caso de uso utilizando el SDK de Solidity.

Creando el proyecto

Podemos utilizar el CLI para crear un nuevo proyecto con un contrato inteligente dentro, y [Solidity SDK]](/solidity) instalado para nosotros.

npx thirdweb create contract

Esto iniciará una serie interactiva de preguntas que te ayudarán a empezar:

  • Dale un nombre a tu proyecto

  • Selecciona Hardhat como marco

  • Selecciona ERC721 como contrato base

  • Selecciona None para las extensiones opcionales

Explorando el proyecto

El comando create genera un nuevo directorio con el nombre de tu proyecto. Abre este directorio en tu editor de texto.

Dentro de la carpeta contracts, encontrarás un archivo Contract.sol; ¡este es nuestro contrato inteligente escrito en Solidity!

Si echamos un vistazo al código, puedes ver que nuestro contrato está heredando la funcionalidad de ERC721Base, por:

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

import "@thirdweb-dev/contracts/base/ERC721Base.sol";

contract Contract is ERC721Base {
    constructor(
        string memory _name,
        string memory _symbol,
        address _royaltyRecipient,
        uint128 _royaltyBps
    ) ERC721Base(_name, _symbol, _royaltyRecipient, _royaltyBps) {}
}

Este patrón de herencia nos permite utilizar la funcionalidad de otros contratos dentro del nuestro, modificarla y añadir lógica personalizada.

Por ejemplo, nuestro contrato actualmente implementa toda la lógica dentro del contrato ERC721Base.sol; que implementa el estándar ERC721A con varias extensiones útiles.

Añadiendo extensiones

Las extensiones son una gran manera de añadir piezas individuales de funcionalidad a su contrato, como los Permisos.

Puedes seguir el mismo patrón que seguimos con el contrato base para añadir una extensión:

Importar

import "@thirdweb-dev contracts extension PermissionsEnumerable.sol";

Heredad

contract Contract is ERC721Base, PermissionsEnumerable {
    // ...
}

Implementar

contract Contract is ERC721Base, PermissionsEnumerable {
    constructor(
        string memory _name,
        string memory _symbol,
        address _royaltyRecipient,
        uint128 _royaltyBps
    ) ERC721Base(_name, _symbol, _royaltyRecipient, _royaltyBps) {
        // Give the contract deployer the "admin" role when the contract is deployed.
        _setupRole(DEFAULT_ADMIN_ROLE, msg.sender);
    }

    // Example: Only allow the "admin" role to call this function.
    function helloWorld() external onlyRole(DEFAULT_ADMIN_ROLE) {
        // ...
    }
}

¡Ya está! 🥳 ¡Acabas de hacer un contrato inteligente de cobro ERC721A NFT con controles de permisos!

Desplegar

Vamos a desplegar nuestro contrato en la blockchain, ejecutando el siguiente comando:

yarn deploy

¡Ya está! 🥳 Este comando hace lo siguiente:

  • Compila tu contrato

  • Sube el código fuente de tu contrato (ABI) a IPFS

  • Abre el dashboard para que selecciones una de nuestras redes soportadas para desplegar en ella

thirdweb CLI - thirdweb deploy

En primer lugar, tenemos que introducir los valores para el constructor de nuestro contrato:

  • _name: El nombre de nuestro contrato

  • _symbol: El símbolo o "ticker" que se da a los tokens de nuestro contrato

  • _royaltyRecipient: La dirección del monedero que recibirá los royalties de las ventas secundarias

  • _royaltyBps: Los puntos básicos (bps) que se darán al receptor de royalties por cada venta secundaria, por ejemplo 500 = 5%.

Por último, selecciona la red en la que deseas desplegar (recomendamos la red de prueba Mumbai), y haz clic en "Deploy Now".

Deploying your contract using the thirdweb dashboard

Una vez desplegado tu contrato, se te redirigirá al panel de control de tu contrato.

Despliegue desde la fuente

¿Ya tiene un contrato listo para desplegar? Aprenda a utilizar nuestro CLI interactivo para enviarlo.

Despliegue de tu contrato inteligente

Utilice el CLI para desplegar su contrato inteligente en la blockchain.

Desde el mismo directorio que tu archivo de contrato inteligente .sol, ejecuta el siguiente comando:

npx thirdweb deploy

¡Ya está! 🥳 Este comando hace lo siguiente:

  • Compila tu contrato

  • Sube el código fuente de tu contrato (ABI) a IPFS

  • Abre el dashboard para que selecciones una de nuestras redes soportadas para desplegar en ella

thirdweb CLI - thirdweb deploy

Abre la URL generada en tu navegador y rellena los campos del constructor de tu contrato inteligente.

Por último, selecciona la red en la que deseas desplegar (recomendamos la red de prueba Mumbai), y haz clic en "Deploy Now".

Deploying your contract using the thirdweb dashboard

Una vez desplegado tu contrato, se te redirigirá al panel de control de tu contrato.

Gestión de contratos

El panel de control es una ubicación central donde puedes gestionar y analizar tu contrato inteligente, con herramientas que te permiten realizar operaciones administrativas comunes, con funciones como:

  • Explorador de contratos: Ejecuta cualquier función en tu contrato y revisa los resultados en tiempo real.

  • Eventos: Feed actualizado en tiempo real de los eventos emitidos por su contrato.

  • Ajustes: Actualiza los metadatos del contrato, los royalties y las tarifas de la plataforma, etc.

  • Fuentes: Vista de todo el código fuente de su contrato y verificación del contrato en Etherscan.

  • Código: Aprende a utilizar el SDK para interactuar con tu contrato

Cada extensión que implementes desbloqueará funciones adicionales en el panel de control. Por ejemplo, el contrato que implementaste en el paso anterior tiene desbloqueadas las pestañas NFTs y Permissions

Explorador de contratos

Conecta tu monedero y ejecuta cualquier función disponible en tu contrato inteligente directamente desde el panel de control.

NFTs

Como nuestro contrato implementa el estándar ERC721, desbloqueamos la pestaña NFTs en el panel de control.

Aquí podemos ver todos los NFT minteados por nuestro contrato, e incluso mintear nuevos.

Permissions

Como nuestro contrato también implementa la extensión Permissions, desbloqueamos la pestaña Permisos en el panel de control.

Invita fácilmente a los miembros de tu equipo con niveles de permiso escalonados y gestiona su acceso a tu contrato.

Builds

La pestaña Build proporciona los pasos para crear una nueva aplicación con nuestro SDK, e interactuar con tu contrato.

Veamos a continuación cómo podemos utilizar el SDK para crear una aplicación web.

Construye una aplicación Web3

Utiliza el CLI para crear una aplicación web con los SDK de React y TypeScript preconfigurados:

npx thirdweb create app

Esto iniciará una serie interactiva de preguntas que te ayudarán a empezar:

  • Dale un nombre a tu proyecto

  • Selecciona Next.js como framework

  • Selecciona JavaScript como lenguaje

El tutorial, a diferencia de la captura, será con JavaScript. Si quieres conocer más sobre TypeScript tienes más información aquí

Explorando el proyecto

El comando create genera un nuevo directorio con el nombre de su proyecto. Abre este directorio en tu editor de texto.

Dentro del archivo index.js, encontrarás el ThirdwebProvider envolviendo toda la aplicación.

Este wrapper nos permite utilizar todos los ganchos de React SDK y los componentes de interfaz de usuario en toda la aplicación, así como configurar un activeChain, que declara en qué cadena se despliegan nuestros contratos inteligentes.

Dado que hemos desplegado nuestro contrato inteligente en la red Mumbai, vamos a establecer el activeChain a "mumbai"

Interactuando con los contratos

Con el SDK instanciado, ya puedes desplegar contratos inteligentes, interactuar con ellos y mucho más.

Para conectarse al contrato, utiliza el método getContract del SDK y el método call para leer/escribir datos.

Las funciones se llaman automáticamente desde la cartera con la que instancias el SDK.

import { useContract } from "@thirdweb-dev/react";

export default function Home() {
  const { contract } = useContract("<CONTRACT_ADDRESS>");

  // Ahora puedes utilizar el contrato en el resto del componente.
}

Ahora puedes llamar a cualquier función de tu contrato inteligente con los hooks useContractRead y useContractWrite. Cada extensión que implementes en tu contrato inteligente también desbloquea una nueva funcionalidad para que la utilices en el SDK.

Veamos cómo funciona esto leyendo los NFTs de nuestro contrato inteligente y acuñando nuevos.

Lectura de datos

El contrato NFT Collection que construimos anteriormente implementa las extensiones ERC721 y ERC721Supply.

Al hacerlo, podemos utilizar la funcionalidad "View All" en nuestra aplicación. En el SDK de React, esto está disponible a través del hook useNFTs, que podemos utilizar proporcionando el objeto del contract al hook de la siguiente manera:

import { useContract, useNFTs } from "@thirdweb-dev react";

export default function Home() {
  const { contract } = useContract("<CONTRACT_ADDRESS>");
  const { data: nfts, isLoading: isReadingNfts } = useNFTs(contract);
}

Visualización de datos

Utiliza el componente NFT Media Renderer para renderizar cada uno de los NFT cargados desde el hook useNFTs, haciendo uso del estado de carga en una sentencia condicional:

import { useContract, useNFTs, ThirdwebNftMedia } from "@thirdweb-dev react";

export default function Home() {
  const { contract } = useContract("<CONTRACT_ADDRESS>");
  const { data: nfts, isLoading: isReadingNfts } = useNFTs(contract);

  return (
    <>
      {isReadingNfts ? (
        <p>Loading...< p>
      ) : (
        <div>
          {nfts?.map((nft) => (
            <ThirdwebNftMedia metadata={nft.metadata} key={nft.metadata.id}  >
          ))}
        </div>
      )}
    </>
  );
}

Escritura de transacciones

Dado que nuestro contrato inteligente implementa la extensión ERC721Mintable, la función mint está disponible para nosotros en el SDK.

Utiliza el componente Web3Button para realizar una transacción mint; lo que asegura que el usuario tiene su monedero conectado y está en la red correcta antes de llamar a la función:

// Coloca este import en la parte superior del archivo
import { Web3Button } from "@thirdweb-dev/react";

// ...

// Colóquelo debajo de su lógica de visualización NFT existente:
<Web3Button
  contractAddress={"<CONTRACT_ADDRESS>"}
  action={(contract) =>
    contract.erc721.mint({
      name: "Hello world!",
      // Coloca aquí cualquier URL o archivo
      image: "<your-image-url-here>",
    })
  }
>
  Mint NFT
</Web3Button>;

Despliega tu aplicación

Para alojar tu aplicación en IPFS y compartirla con el mundo, ejecuta el siguiente comando:

yarn deploy

¡Ya está! 🥳 Este comando utiliza Storage para:

  • Compilar para producción

  • Subir la compilación a IPFS

  • Generar una URL donde tu app esté alojada permanentemente.

Comparte con nosotros tu aplicación

https: twitter.com thirdweb_es

¿Y ahora qué?

¡Enhorabuena por haber llegado hasta aquí! 🎉

Ahora que has aprendido lo básico, lleva tus habilidades al siguiente nivel construyendo sobre nuestras plantillas.

Recursos adicionales

Si tienes alguna pregunta, únete a los más de 36.000 creadores de nuestra comunidad de Discord, o ponte en contacto directamente con el equipo para obtener más información sobre cómo empezar con thirdweb.

Y si quieres empezar a construir aplicaciones web3, empieza con las herramientas web3 y SDKs de thirdweb - ¡son gratis!

]]> samusarmiento@newsletter.paragraph.com (thirdweb ES) thirdweb thirdweb_es documentacion-thirdweb <![CDATA[Documentación thirdweb: Inicio y visión general]]> https://paragraph.com/@samusarmiento/documentacion-thirdweb-primeros-pasos Ryu39CqUkU4WCyFoL3TQ Fri, 02 Jun 2023 08:40:12 GMT Primeros pasos en thirdweb
documentación thirdweb en español

En estas guías repasaremos la documentación y cómo dar los primeros pasos con el framework más completo para el desarrollo de apps y juegos en Web 3: thirdweb. Un marco de desarrollo integral que te permite crear, lanzar y gestionar sin problemas aplicaciones y juegos web3 en cualquier blockchain compatible con EVM.

Descubre cómo crear y lanzar una aplicación web3 en tu lenguaje preferido:

  1. React

  2. React Native

  3. TypeScript

  4. Python

  5. Go

  6. Unity

  7. Solidity

Visión general

Arquitectura

Tanto si está desarrollando aplicaciones descentralizadas desde cero o mejorando las existentes, el conjunto de herramientas de thirdweb acelera tu flujo de trabajo de desarrollo en todas las estapas: contratos inteligentes, aplicaciones e infraestructura.

platform-overview

Herramientas

Las principales herramientas que nos presenta thirdweb son las siguientes:

  • Solidity SDK: Contratos base que pueden configurarse con extensiones para adaptarse a su caso de uso específico

  • Explorar: Descubre y despliega contratos de protocolos y desarrolladores de talla mundial en 1 clic

  • SDK: Potentes SDK para cada stack. Compatible con Javascript, TypeScript, React, Python, Go, Node.js, Unity...

  • Componentes UI: Plug and play. Componentes de interfaz de usuario para añadir fácilmente funcionalidad web3 a tus aplicaciones.

  • Despliegues: Despliegue de contratos on-chain con un sencillo flujo de trabajo de despliegue diseñado para la colaboración en equipo.

  • Publicar: Publica tus contratos para que los descubra la comunidad de más de 70.000 desarrolladores web3

  • Panel de control: Gestiona, analiza e interactúa cómodamente con todos los contratos desplegados desde un único lugar.

  • CLI: Un conjunto de comandos que te permiten interactuar con herramientas de thirdweb a través de la terminal.

Smart Contracts

Los contratos inteligentes son los cimientos de cualquier aplicación descentralizada. Realizan auditorías de los contratos preconstruidos para garantizar el máximo nivel de calidad y seguridad. También optimizan los contratos para la eficiencia del gas, minimizando los costes de transacción. Al priorizar estas consideraciones técnicas, los desarrolladores pueden centrarse en crear aplicaciones web3 excepcionales con confianza y facilidad.

thirdweb está diseñado para integrarse con cualquier contrato en cualquier blockchain sin problemas. Con el SDK de Solidity, puede crear y personalizar rápidamente contratos inteligentes y, al mismo tiempo, habilitar extensiones para desbloquear más funcionalidades. Tanto si despliegas tu contrato inteligente, sin utilizar una clave privada, con el comando Deploy CLI, como si importas un contrato ya desplegado o coges un contrato preconstruido a través de Explore. Una vez desplegado, en el panel de control, puedes gestionar fácilmente el contrato inteligente y realizar un seguimiento de su rendimiento a través de Data Feeds.

Aplicaciones

thirdweb ofrece kits de desarrollo de software (SDK) que permiten una integración perfecta con contratos inteligentes al desarrollar aplicaciones o juegos utilizando lenguajes de programación populares como React, React Native, TypeScript, Python, Go y Unity.

Los SDK detectan las extensiones o patrones y estándares comunes de Ethereum (es decir, ERC-20, ERC-721, ERC-1155) utilizados en el contrato inteligente y proporcionan funcionalidad adicional para permitir construir aplicaciones con facilidad. Por ejemplo, si tu contrato utiliza la extensión ERC-721, el SDK te proporcionarán un conjunto de funciones para interactuar fácilmente con los NFT de tu contrato. Además, los SDK permiten la conectividad de wallets y proporcionan conjuntos especializados de funciones para URL de llamada a procedimiento remoto (RPC) y una pasarela IPFS.

Básicamente, te permite aprovechar las capacidades de otro programa o función sin tener que tenerlo instalado en tu propia computadora y que las aplicaciones se conecten y compartan información de manera segura y eficiente.

Estas funciones optimizan el rendimiento y mejoran la experiencia de los desarrolladores a la hora de crear aplicaciones descentralizadas.

Infraestructura

thirdweb ofrece un conjunto completo de herramientas y tecnologías para facilitar el desarrollo de aplicaciones descentralizadas accesibles y fáciles de usar. La infraestructura incluye opciones para pagos fiat, integraciones de monederos y relayers sin gas, proporcionando experiencias de usuario final sin fisuras.

Además, proporcionan soluciones de almacenamiento y RPC integradas para optimizar el rendimiento y la descentralización de las aplicaciones. El indexador y Data Feeds permiten una fácil integración de los datos de su contrato en la aplicación.

El SDK de autenticación está diseñado para permitir el inicio de sesión descentralizado y una integración perfecta con los marcos de cliente y servidor. Esta característica permite a los desarrolladores crear aplicaciones descentralizadas seguras y fáciles de usar que pueden desplegarse e integrarse fácilmente con otras aplicaciones.

Soluciones

Desde thirdweb se comprometen a proporcionar conjuntos de herramientas completos para desarrolladores de diversos sectores, como el de los juegos, el comercio electrónico, las finanzas, el arte y las redes sociales, entre otros. Estas soluciones incorporan una serie de herramientas y tecnologías, propias y en colaboración con líderes del sector.

GamingKit, desarrollado en colaboración con Coinbase, ofrece un enfoque simplificado para crear juegos basados en blockchain. Incluye contratos preconstruidos como Marketplace, Multiwrap, Packs, Tokens, etc., y un SDK de Unity para crear tu juego. GamingKit también permite soluciones sencillas de pago en fiat a través de Coinbase Pay.

Del mismo modo, CommerceKit, desarrollado en colaboración con Shopify, permite la creación de tiendas basadas en blockchain que pueden recompensar a los clientes con activos digitales. El kit de herramientas incluye funciones para habilitar el comercio basado en tokens, programas de fidelización y herramientas de configuración sencilla para ventas de coleccionables digitales/tasas de regalías.

La solución de Mint permite una mecánica de minteo creativa y la gestión de activos digitales creados tanto en los contratos EVM como en los programas de Solana. Incluye herramientas para la acuñación basada en firmas, la liberación de colecciones de NFT únicos, envolver fichas en nuevos NFT envueltos, cajas de botín aleatorias y mucho más.

Además ofrecen un conjunto de herramientas para desarrolladores y SDKs que facilitan la integración de las funciones de web3 en aplicaciones iOS y Android.

Recursos adicionales

Si tienes alguna pregunta, únete a los más de 36.000 creadores de nuestra comunidad de Discord, o ponte en contacto directamente con el equipo para obtener más información sobre cómo empezar con thirdweb.

Y si quieres empezar a construir aplicaciones web3, empieza con las herramientas web3 y SDKs de thirdweb - ¡son gratis!


]]> samusarmiento@newsletter.paragraph.com (thirdweb ES) thirdweb thirdwebes documentacion-thirdweb <![CDATA[Documentación thirdweb: Panel de control]]> https://paragraph.com/@samusarmiento/thirdweb-panel-de-control wAmF8uxh80mXJe8HTx61 Wed, 07 Jun 2023 10:28:47 GMT Panel de control

Visión General

Mediante el panel de control puedes desplegar, interactuar y gestionar sus contratos, configurar el almacenamiento, las RPC, los monederos y mucho más.

El panel de control te permite desplegar o importar cualquier contrato en una red compatible con EVM y gestionar la configuración.

Algunas acciones habilitadas a través del cuadro de mandos

  • Actualización de los metadatos del contrato

  • Carga de NFT individuales o por lotes

  • Transferencia, grabación o airdrops de NFT

  • Establecer condiciones de reclamación (en contratos que implementan las extensiones Claimable, Drop o DropSinglePhase)

  • Gestionar los permisos de los contratos (en los contratos que implementan la extensión Permissions)

Guía relacionada

dashboard-overview

Desbloqueo de las funciones del panel de control

Todos los contratos vienen con un conjunto de vistas por defecto, incluyendo:

  • Build

  • Explorer

  • Events

  • Settings

  • Sources

Por cada contrato que despliegues utilizando el panel de control, el CLI o la importación, desbloquearás funciones en el panel de control para cada extensión que haya implementado en el contrato.

Build

La vista de Build proporciona fragmentos de código para interactuar con tu contrato utilizando SDKs de terceros. Los fragmentos de código se generan automáticamente en función de las funciones de lectura/escritura del contrato y las extensiones compatibles.

Lenguajes

Build proporciona fragmentos de código en todos los SDK de terceros proporcionados: TypeScript, React, React Native, Python, Go y Unity.

Para cambiar los fragmentos de código, selecciona un idioma en el menú desplegable de la página Build (arriba a la derecha).

Explorer

Explorer o el Explorador de Contratos es una herramienta que permite a cualquiera ver y llamar fácilmente (dependiendo de los permisos) a todas las funciones del contrato inteligente desde su monedero conectado a través del panel de control. Esta herramienta también ayuda a los desarrolladores a probar las llamadas a funciones en su contrato sin necesidad de utilizar un script o una herramienta CLI.

Funciones de escritura

Las funciones de escritura modifican el estado de la blockchain a través del contrato. Por lo tanto, las funciones de escritura requieren tasas de gas para ejecutarse, ya que están actualizando el estado de la blockchain.

Funciones de lectura

Las funciones de lectura leen el estado de la cadena de bloques. Las funciones de lectura no modifican ningún dato, por lo que no requieren tasas de gas para ejecutarse.

Events

En la vista Events, puedes ver una lista actualizada de todas las transacciones emitidas en el contrato y su correspondiente número de bloque y hash. Los desplegables ofrecen una vista detallada de los datos del evento.

Settings

En la vista de configuración, puedes cambiar los campos que configuraste inicialmente al desplegar el contrato por primera vez, como Metadatos, Ventas principales, Royalties y Fees de plataforma.

Metadatos

Los metadatos se refieren a los metadatos del contrato que aparecen en la cadena de bloques o en páginas como la de la colección OpenSea. Para cambiar los metadatos, introduce una imagen, un nombre y una descripción en los campos y haz clic en "Update Metadata". Esto provocará una transacción en tu monedero.

INFO

Los metadatos de los símbolos no pueden modificarse una vez desplegado el contrato.

Ventas primarias

Las Ventas Primarias son los ingresos recibidos en la venta inicial de activos. Para cambiar los cánones, introduce una dirección en los campos y haga clic en "Update Primary Sale Settings". Esto provocará una transacción en tu monedero.

Royalties

Los Royalties se perciben por las ventas secundarias de activos. Para cambiar el porcentaje, introduce una dirección y el porcentaje correspondiente en los campos y haga clic en "Update Royalty Settings". Esto provocará una transacción en tu monedero.

Fees de la plataforma

Las comisiones de la plataforma son las comisiones percibidas por una plataforma. Suelen utilizarse si estás desplegando este contrato para un tercero y quieres cobrar tasas por los servicios. Para cambiar las comisiones de plataforma, introduce una dirección y el porcentaje correspondiente en los campos y haga clic en "Update Platform Fee Settings". Esto provocará una transacción en tu monedero.

Sources

En la vista de fuentes, puedes comprobar el código fuente compilado de tu contrato y verificarlo en sitios como Etherscan.

Verificación de contratos

Todos los contratos desplegados en las siguientes cadenas se verificarán automáticamente a través de thirdweb:

NFTs

INFO

Esta función está disponible en los contratos que aplican la extensión erc-721 o erc-1155 (o el estándar del sector).

Reclamar

Para reclamar un NFT directamente en tu contrato, sigue estos pasos:

  1. Haga clic en el botón Claim en la vista NFT.

  2. Pega la dirección para reclamar los NFT y el número de NFT.

  3. Haga clic en el botón Claim NFT.

Subida única

La carga única de NFTs es el método preferido para cargar NFTs puntuales o pequeñas cantidades de NFTs.

Sigue estos pasos para cargar un solo NFT a tu contrato.

  1. Para cargar un único NFT, ve a la vista de NFT y haga clic en el botón Single Upload.

  2. Rellena los campos de metadatos NFT correspondientes, incluyendo Nombre, Media y Descripción en el modal.

  3. (Opcional) Añade propiedades o rasgos para la NFT.

  4. (Opcional) Configura opciones avanzadas de metadatos como Color de fondo y URL externa.

  5. Haz clic en el botón Lazy Mint cuando esté listo para mintear. Esta acción provocará una transacción en tu monedero.

Subida por lotes

La carga por lotes de NFT es una opción preferente para los NFT y los metadatos correspondientes que deban cargarse en bloque. Actualmente solo está disponible para los contratos que tienen la extensión Drop o Drop1155.

CSV

  1. Haz clic en el botón Batch Upload en la vista NFTs del panel de control.

  2. Descarga el archivo CSV de muestra (recomendado) o JSON, que contiene un ejemplo de la estructura esperada.

    Screenshot of NFT view

  1. Después de la descarga, abre la hoja en un editor CSV. Puedes utilizar Microsoft Excel, Google Sheets o cualquier otro software o editor de texto que admita la edición de archivos CSV.

CONSEJO

Google Sheets es una gran opción para principiantes si no estás familiarizado con el uso de software de hojas de cálculo. Su uso es gratuito con una cuenta de Google y se puede utilizar en cualquier navegador, sin necesidad de descargar software.

  1. En Google Sheets, puedes hacer clic en archivo > importar para cargar el archivo CSV de muestra para editarlo. Cuando abras el archivo de muestra, encontrarás un par de encabezados de columna con la primera fila de propiedades rellenada.

    Screenshot of NFT view

Resumen de las diferentes propiedades:

  • name: El nombre de la NFT

  • description: Descripción de la NFT

  • external_url: Esta URL aparece debajo de la imagen en marketplaces como OpenSea y permite a los usuarios ver la NFT desde su sitio.

  • background_color: Una propiedad opcional disponible en OpenSea. Debe utilizar el formato hexadecimal de seis dígitos (#).

  • youtube_url: Similar a la URL externa, esto permitirá a los usuarios ver el canal de YouTube o el vídeo detrás de la NFT.

Esta opción también te permite cargar una variedad de diferentes tipos de archivos. El archivo CSV se utiliza para añadir el archivo NFT junto a las propiedades, que se analizarán.

  • image: Un enlace a la imagen o archivo a subir. El enlace puede ser una imagen local o una URL de un NFT cargado en un servicio, como IPFS. Tipos de archivo admitidos: png, jpg, jpeg y gif.

  • animation_url: enlace a la animación que se va a cargar. Tipos de archivo admitidos: cualquier archivo que no sea una imagen, como mp4, archivos de audio, pdf, CSV, modelos 3d, etc.

Además de estas propiedades específicas, también puedes añadir propiedades que pueden ser únicas para su colección. En el siguiente ejemplo, tenemos un proyecto NFT Shapes Collection con propiedades de forma, color y lados.

Screenshot of shapes view

  1. Una vez que hayas terminado de editar, exporta tu archivo como .csv y añádelo a una carpeta con todos tus activos.

  2. Sube tus activos al panel de control, comprueba que tu colección está correctamente asignada y haz clic en Next, donde se te pedirá que configures más opciones.

    Gif of drag and drop

JSON

Se recomienda utilizar el formato JSON cuando se utilice un generador de NFT que genere NFT y sus metadatos correspondientes en un archivo JSON.

CONSEJO

Algunos generadores que recomendamos son Hashlips y niftygenerator. La función de carga es compatible con cualquier generador.

Recursos adicionales

Si tienes alguna pregunta, únete a los más de 36.000 creadores de nuestra comunidad de Discord, o ponte en contacto directamente con el equipo para obtener más información sobre cómo empezar con thirdweb.

Y si quieres empezar a construir aplicaciones web3, empieza con las herramientas web3 y SDKs de thirdweb - ¡son gratis!

]]> samusarmiento@newsletter.paragraph.com (thirdweb ES) thirdweb thirdweb_es documentacion-thirdweb