{% endhint %}
#### Alternative
{% hint style="info" %}
Still need help? No worries! Reach out to our support team via email at 
| Concern | Clarity |
|---|---|
| Wallet addresses or contacts | Not shared with the AI. Only internal pseudonymous IDs are used. |
| Token Names | A list of your token names is shared so the AI can recognize inputs like “send 5 ICP." in the example above |
| Token Balance | Not shared. The model does not know how much you hold. Balance data is rendered by OISY and never sent to the AI, even when shown in chat. |
| Sensitive info typed by user | Only what you type directly is included in the prompt. |
| IP Address | Not exposed. Requests are routed through an intermediary layer. |
OISY icon
#0066FFWhenever possible, use this exact hex value to maintain visual consistency across integrations. |  |
General Overview
General Overview - Dark mode
Chain Fusion Conversion Inteface
Send Interface
SWAP Interface
Light background
Dark background
| Library | Versions |
|---|---|
| @nfid/identitykit | 2.0.0 |
| @windoge98/plug-n-play | - |
Figure: How dApp, OISY, and ICP Ledger talk together.
Please connect your wallet using the button above.
; } return (Connected Principal: {principal?.toText()}
{accounts && accounts.length > 0 &&Your Account ID (from OISY): {accounts.address}
}Not Connected
// document .getElementById('connect-oisy-signerjs') ?.addEventListener('click', connectOisyWithSignerJs); document .getElementById('disconnect-oisy-signerjs') ?.addEventListener('click', disconnectOisyWithSignerJs); ``` **Making Calls (Example with SignerAgent):**\ Use the `walletAgent` (which is a `SignerAgent`) to create actors and call canister methods. ```ts // (Continuing from the previous signer-js example) async function transferIcpWithSignerJs() { if (!walletAgent || !userAccountsFromWallet || userAccountsFromWallet.length === 0) { alert('Not connected or no accounts available!'); return; } // Example recipient (ensure this is a valid account structure for the ledger) const recipientPrincipal = Principal.fromText('uzr34-vyaaa-aaaaq-aaaea-cai'); // Replace const recipientAccount: Account = { owner: recipientPrincipal, subaccount: [] }; // ICRC-1 style account const amount = 500_000n; // 0.005 ICP (500,000 e8s) try { // Use IcrcLedgerCanister helper for ICRC-1 compliant ledgers. // Note: The main ICP ledger is not strictly ICRC-1 but has a similar transfer method. // For the actual ICP ledger, you might need its specific IDL and AccountIdentifier type. // This example assumes an ICRC-1 ledger for simplicity with @dfinity/ledger-icrc. // If targeting ICP ledger, you'd use its specific `transfer` args. // Let's assume we are interacting with an ICRC-1 ledger canister const icrcLedger = IcrcLedgerCanister.create({ agent: walletAgent, // The agent that will use OISY for signing canisterId: Principal.fromText('mxzaz-hqaaa-aaaar-qaada-cai'), // Example ICRC-1 ledger ID (ckBTC) }); console.log('Requesting ICRC-1 transfer via signer-js agent to OISY...'); // This call will be sent to OISY for signing via the SignerAgent -> Signer -> Transport chain. // OISY will show an ICRC-21 consent message. const blockIndex = await icrcLedger.transfer({ to: recipientAccount, amount: amount, // fee, memo, from_subaccount, created_at_time are optional for ICRC-1 transfer // and might be automatically filled or handled by OISY/ledger defaults. }); console.log(`ICRC-1 Transfer OK! Block index: ${blockIndex}`); alert(`ICRC-1 Transfer successful! Block index: ${blockIndex}`); } catch (error) { console.error('ICRC-1 Transfer failed:', error); alert(`ICRC-1 Transfer failed: ${error.message || error}`); } } // Add listener to a transfer button document .getElementById('transfer-icp-signerjs') ?.addEventListener('click', transferIcpWithSignerJs); ``` When `icrcLedger.transfer` (or any other update call via an actor using `walletAgent`) is executed, the `SignerAgent` directs the signing request to OISY. OISY then presents the user with a consent popup (formatted according to ICRC-21, if the wallet supports it well). If the user approves, OISY signs the transaction, and it's dispatched to the IC.Not Connected
// document.getElementById('connect-oisy-lib')?.addEventListener('click', connectWithOisyLib); document.getElementById('transfer-oisy-lib')?.addEventListener('click', transferWithOisyLib); document.getElementById('disconnect-oisy-lib')?.addEventListener('click', disconnectOisyLib); ``` * `OisyWalletSigner.create()` handles the connection setup. * The library provides an `agent` (`oisyClient.agent`) that is pre-configured to route signing requests through OISY. You use this agent to create actors for your canisters. * It should also manage the communication channel and potentially offer a disconnect method (though check its latest API for specifics)
No forms. No claims. No gas.
Just stay active- and if you refer, make it count.
