Billetera y multi-dispositivo - Meru

El cliente de billetera ejecuta las acciones del usuario (crear, enviar, recuperar) contra tu backend. La aprobación ocurre en el dispositivo del usuario; Meru completa la transferencia y cubre la comisión.

Construir

import { MeruDeviceWallet } from "@meru.app/device-signer/wallet";

const wallet = new MeruDeviceWallet({
  baseUrl: "https://your-app.com/api/meru",
  userId: session.user.id,
  getToken: async () => auth.current()?.token ?? null,
});

final wallet = MeruDeviceWallet(
  baseUrl: 'https://your-app.com/api/meru',
  getToken: () async => auth.current?.token,
  keyId: 'meru.device-key.${session.user.id}',
);

let wallet = MeruDeviceWallet(
    baseURL: URL(string: "https://your-app.com/api/meru")!,
    userId: session.user.id,
    getToken: { auth.current?.token }
)

val wallet = MeruDeviceWallet(
    baseUrl = "https://your-app.com/api/meru",
    keys = DeviceKeyStore(applicationContext),
    userId = session.user.id,
    getToken = { auth.current?.token },
)

Multi-dispositivo: siempre llama a `status()` primero

La llave de la billetera nunca sale del dispositivo, así que iniciar sesión en un teléfono nuevo no la copia. status() combina “¿el usuario tiene billetera?” con “¿este dispositivo tiene su llave?” y te dice la única acción correcta.

`status().state`	Significado	Acción
`create`	El usuario todavía no tiene billetera.	`enroll({ activate: true })`
`recover`	El usuario tiene billetera en otro dispositivo; este necesita configurarse.	`recover()`
`ready`	Este dispositivo está listo para enviar.	`send` / `signMessage`

En un segundo dispositivo, llamar a enroll() en vez de recover() iniciaría una billetera separada. Siempre ramifica según status().

Recibir funciona en cualquier dispositivo de inmediato — la dirección de la billetera es pública.
Enviar desde un dispositivo nuevo requiere recover() una vez. Restaura este dispositivo a la billetera existente del usuario (misma billetera, misma dirección) a través del servicio de recuperación de Meru, autorizado por el login del usuario.

Métodos

Llamada	Qué hace
`status()`	`create` / `recover` / `ready` para este dispositivo.
`enroll({ activate })`	Configura la billetera en este dispositivo (opcionalmente actívala ya).
`activate()`	Configuración inicial de la billetera, cubierta por Meru.
`send(to, amount)`	Envía dólares. Aprobado en el dispositivo; Meru cubre la comisión.
`recover()`	Restaura este dispositivo a la billetera existente del usuario.
`signMessage()`	Prueba el control de la billetera sin mover dinero.
`forget()`	Elimina la llave de este dispositivo al cerrar sesión.

Enviar

const txHash = await wallet.send("GB7C…FB2Q", 5);

final txHash = await wallet.send('GB7C…FB2Q', 5);

let txHash = try await wallet.send(to: "GB7C…FB2Q", amount: 5)

val txHash = wallet.send("GB7C…FB2Q", 5.0)

Cerrar sesión

Elimina la llave del dispositivo y borra la sesión. Perder la llave no es problema — la billetera se recupera volviendo a iniciar sesión.

await wallet.forget();
await auth.logout();

try wallet.forget()
auth.logout()

wallet.forget()
auth.logout()