Código abierto · MIT · para Playwright y Vitest

El wallet que hace lo que dice tu test.

Un wallet Wallet Standard real que tu dApp lista junto a Phantom — salvo que el botón de aprobar es una línea de tu test de Playwright. Conectar, firmar, enviar, cancelar, fallar, cambiar de cuenta. En CI. Sin extensión, sin devnet.

npm i -D @solana-e2e/wallet @solana-e2e/playwright
Una línea de código de test, wallet.rejectNext(), está unida con hilos a la ventana de un wallet cuyo botón Reject se pulsa solo; un aviso dice que el usuario rechazó la petición y que el test pasó.

Cada equipo escribe el suyo

Cuatro búsquedas de código en GitHub (1, 2, 3, 4) devuelven más de 100 archivos de mocks Wallet Standard escritos a mano e inyectados en Playwright, en decenas de repositorios —entre ellos Uniswap y ZeroDev— y ninguno es un paquete reutilizable.

CaracterísticaManejar una extensión realMock escrito a manosolana-e2e
Sin descargar extensiones, en modo headlessNoSíSí
signAndSendTransaction, signInSíPocas vecesSí
Rechazar, fallar o aprobar desde el testCon las ventanasSi lo programasUna línea cada uno
Varias cuentas y eventos changeSíPocas vecesSí
Transacción comprobada en una cadena localRequiere montarloPocas vecesFixture incluido
Mantenido una vez, para todosLas ventanas cambianCopiado en cada repoPaquete npm

Playground

Una dApp pequeña y, a su lado, el @solana-e2e/wallet real funcionando en esta pestaña en modo mock, con los botones que pulsaría un test. Cada clic se convierte en una línea del spec de Playwright de abajo. Nada sale de tu navegador, salvo que apuntes el wallet a tu propia cadena local.

Cargando el wallet de pruebas…

Cómo funciona

En modo mock la petición se queda en el TestWallet: firma y responde, y no se envía nada. En modo rpc sigue hasta Surfpool. El playground de arriba no usa el puente de Playwright: la carcasa y el TestWallet funcionan los dos dentro de tu pestaña.

Pasa el ratón o toca un paso para seguirlo en el diagrama.

Lo que ahora puedes probar

  • El usuario cancela

    wallet.rejectNext({ method: "signMessage" })
  • Falla el wallet o la red

    wallet.failNext({ code: -32002, message: "Blockhash not found" })
  • Una petición espera aprobación

    wallet.setApproval("manual"); … wallet.approve()
  • El usuario cambia de cuenta a mitad del flujo

    wallet.switchAccount("bob")
  • Un wallet sin firmar y enviar

    { disabledFeatures: ["solana:signAndSendTransaction"] }
  • Una versión de transacción no soportada

    { supportedTransactionVersions: ["legacy", 0] }
  • autoConnect en un sitio no confiable (por defecto)

    { trusted: false }
  • Una extensión que se carga tarde

    installTestWallet(page, { late: true })

Dos modos

mock

Firma de verdad y no envía nada. Para tests de interfaz y para Vitest + jsdom, donde registerTestWallet() sustituye a un mock-wallet.ts escrito a mano.

const { wallet } = await registerTestWallet({ accounts: ["alice"] });

rpc

Firma, envía a un RPC local y espera el commitment. Con @solana-e2e/playwright tienes una cadena Surfpool por worker y un wallet con fondos por test.

const tx = await localnet.getTransaction(signature);
expect(tx.logs).toContain("Program log: hello");

En CI

Los specs en modo mock solo necesitan Playwright. Para el modo rpc, instala Surfpool desde su release y comprueba el sha256 del archivo; la receta completa de GitHub Actions está en docs/ci.md. La CI de este proyecto ejecuta los dos tipos en Linux, macOS y Windows.

Limitaciones

  • El transporte de Playwright es un puente a Node, así que el wallet inyectado no funciona tal cual en Cypress ni en Storybook. El uso dentro de la página, como en este playground, funciona en modo mock.
  • Los paquetes se prueban en Chromium en la CI; este sitio se prueba también en WebKit.
  • Una cuenta visible a la vez, como en Phantom.
  • Es una herramienta de test: nunca le des una clave con fondos reales.