provider-wai
v0.1.6
Published
Waves @waves/signer provider using a secure iframe wallet (WAI Wallet).
Maintainers
Readme
provider-wai
Provider Waves Signer qui pilote un wallet dans une iframe (postMessage), pour intégrer WAI Wallet ou un fork compatible sur ton site / dApp.
Installation
npm install provider-wai @waves/signerUsage
import { Signer } from '@waves/signer';
import { ProviderWAI } from 'provider-wai';
const signer = new Signer({
NODE_URL: 'https://nodes.wavesnodes.com'
});
signer.setProvider(
new ProviderWAI({
origin: 'https://ton-wallet.example/signer',
requestTimeoutMs: 120_000,
logs: false
})
);
await signer.login();origin: URL de la page signer (idéalement…/signer). Si tu passes seulement l’origine du site (https://wallet.examplesans chemin), provider-wai ajoute automatiquement/signerpour éviter de charger/(souvent protégée par CSPframe-ancestors 'self'et non embeddable depuis localhost / autres domaines).- Les types par défaut (
WAI_DEFAULT_SIGNER_ORIGIN, etc.) sont exportés si tu construis l’URL depuis la config.
@waves/signer peut appeler login() avant que connect() ait fini côté provider. ProviderWAI attend en interne la fin d’un connect réussi avant tout autre postMessage, comme les autres providers — inutile de faire await signer.setProvider(...) avant login().
API supportée
Alignée sur @waves.exchange/provider-web côté protocole Signer :
connect,login,logoutsign— tous les types de transactions pris en charge par@waves/waves-transactionssauf les transactions exchange en chaîne (type 7) : celles-ci doivent passer parsignOrder, comme chez WX.signOrder,signMessage,signTypedData
signTypedData renvoie une chaîne JSON du résultat de customData (signature, hash, champs signés), vérifiable avec verifyCustomData côté @waves/waves-transactions.
Licence
MIT
