@tronweb3/tronwallet-adapter-guarda

@tronweb3/tronwallet-adapter-guarda

Wallet adapter for Guarda Extension.

Installation

npm install @tronweb3/tronwallet-adapter-guarda

Usage

import { GuardaAdapter } from '@tronweb3/tronwallet-adapter-guarda';

const adapter = new GuardaAdapter({
    checkTimeout: 2000,
    openUrlWhenWalletNotFound: true,
});

// Connect to wallet
await adapter.connect();

// Get address
console.log(adapter.address);

// Sign transaction
const signedTx = await adapter.signTransaction(transaction);

// Sign message
const signature = await adapter.signMessage('Hello World');

// Disconnect
await adapter.disconnect();

Configuration

Option	Type	Default	Description
checkTimeout	number	2000	Timeout in millisecond for checking if is in Guarda App
openUrlWhenWalletNotFound	boolean	true	Set if open Guarda website when wallet not found

Events

The adapter extends the base adapter and emits the following events:

• readyStateChanged: When the wallet ready state changes
• connect: When the wallet connects

Security Check

GuardaAdapter supports an optional securityOptions field for detecting wallet risks before connect(). When enabled, the adapter fetches a remote risk configuration and calls onRiskDetected if the wallet is flagged.

const adapter = new GuardaAdapter({
    securityOptions: {
        enabled: true,
        configUrls: ['https://your-server.com/security-config.json'],
        onRiskDetected: async ({ risks }) => {
            // Throw to block the connection, or log a warning
            throw new Error(`Wallet risk detected: ${risks[0].title}`);
        },
    },
});

For the full SecurityOptions API reference, see walletadapter.org/docs.

Caveats

• multiSign() and switchChain(chainId: string) are not supported.
• Guarda does not support accounts switching and network switching.
• Guarda does not support auto-reconnect after a page reload.

License

MIT