Plugin del Adaptador de Wallet para Constructores de Wallets SDK
Un plugin del adaptador de wallet permite que las dapps usen tu wallet. Con el estándar de Wallet AIP-62, las dapps pueden simplemente actualizar su versión de aptos-wallet-adapter
para conectarse a plugins de Wallet recién agregados.
Implementar un plugin de wallet para una wallet SDK que se puede importar vía npm tiene tres pasos principales:
- Implementar un plugin del adaptador de wallet para tu wallet SDK.
- Publicar tu plugin en npm.
- Actualizar el paquete
aptos-wallet-adapter
para que las dapps sepan sobre tu wallet.
1. Implementar el Plugin del Adaptador de Wallet.
Sección titulada «1. Implementar el Plugin del Adaptador de Wallet.»Puedes usar el ejemplo del repositorio wallet-standard
para implementar un plugin del adaptador de wallet compatible con AIP-62 que las dapps pueden reconocer automáticamente.
-
Crear un nuevo repositorio de typescript.
-
Copiar el en ese nuevo repo.
-
Seguir las instrucciones en ese ejemplo para hacer que use tu wallet para ejecutar las funciones AIP-62.
Prueba tus cambios por:
Sección titulada «Prueba tus cambios por:»-
Clonar el repositorio.
-
Navegar a en la dapp de ejemplo.
-
Reemplazar con tu implementación del estándar AIP-62.
- Tendrás que actualizar la importación en
aptos-wallet-adapter/apps/nextjs-example/src/app/page.tsx
para usar tu Wallet en lugar deMyWallet
. - Para propósitos de prueba local, puedes dejar el código
registerWallet
, pero las wallets SDK no necesitan eso una vez que han sido agregadas al paquete coreaptos-wallet-standard
.
- Tendrás que actualizar la importación en
-
Ejecutar una versión local de la dapp siguiendo las instrucciones en el .
-
Hacer clic en “Conectar una Wallet”
Deberías ver tu wallet en la lista de conexiones.
-
Conectar a tu wallet.
- Luego puedes usar las características de la dapp de demostración para verificar que tus otras características de wallet funcionen como se espera.
- Esto simula cómo una dapp real interactuará con tu wallet.
2. Una vez probado, publica un nuevo paquete npm para tu código de wallet SDK siguiendo esta guía. (Ej. AptosConnect)
Sección titulada «2. Una vez probado, publica un nuevo paquete npm para tu código de wallet SDK siguiendo esta guía. (Ej. AptosConnect)»3. Actualizar wallet-adapter-core
para que sepa sobre tu extensión.
Sección titulada «3. Actualizar wallet-adapter-core para que sepa sobre tu extensión.»Para que los usuarios de dapps que no están usando tu wallet obtengan la opción de crear una cuenta con tu wallet, necesitas actualizar wallet-adapter-core
con el enlace de descarga de tu extensión de navegador.
-
Hacer fork del monorepo. ()
-
Abrir tu fork en un editor local como VSCode.
-
Crear una nueva rama para tus cambios.
Ventana de terminal git checkout -b your-wallet -
Navegar a .
-
Importar tu paquete npm de wallet SDK.
Ventana de terminal pnpm i @yourpackage -
Importar tu wallet en .
Por ejemplo con AptosConnect:
import { AptosConnectWallet } from "@aptos-connect/wallet-adapter-plugin"; -
Agregar código para empujar una instancia de tu wallet a sdkWallets dentro de getSDKWallets (en sdkWallets.ts).
sdkWallets.push(new YourWallet(dappConfig)); -
En type.ts, actualizar el tipo AvailableWallets para incluir el nombre de tu wallet.
export type AvailableWallets = "Nightly" | "Petra" | "T wallet" | "Tu Nombre de Wallet"; -
Actualizar el en el nivel superior del aptos-wallet-adapter para incluir tu wallet en la lista de wallets compatibles con AIP-62.
-
Hacer commit y push de tus cambios a tu fork.
-
Seguir para abrir un pull request para el repo.
Recursos
Sección titulada «Recursos»- App de Demostración del Adaptador de Wallet
- Sitio en vivo
- Código fuente
- Ver
standardWallet.ts
para un ejemplo de implementación de un plugin de wallet-adapter compatible con AIP-62.
- Código fuente de
wallet-standard
. - Código fuente de
wallet-adapter-core
. - Estándar AIP-62.