Skip to main content
Version: 0.2.2

API Reference

window.ethereum.request()​

All interactions go through the standard EIP-1193 request method:

window.ethereum.request({ method: string, params?: unknown[] }): Promise<unknown>

Methods​

eth_requestAccounts​

Opens Temple wallet via Beacon and returns the EVM alias for the connected tz1 address.

const accounts = await window.ethereum.request({ method: 'eth_requestAccounts' });
// → ['0x341af4de1e67241d8d2536b2ea47c7e9debf7cb2']

eth_accounts​

Returns the currently connected account without prompting.

const accounts = await window.ethereum.request({ method: 'eth_accounts' });
// → ['0x341af4de...'] or []

eth_chainId / net_version​

Chain ID as hex (eth_chainId) or decimal string (net_version).

await window.ethereum.request({ method: 'eth_chainId' });    // → '0x1f094'
await window.ethereum.request({ method: 'net_version' });    // → '127124'

eth_getBalance​

Returns the balance of an address in wei (as hex). Proxied to Tezlink.

await window.ethereum.request({
  method: 'eth_getBalance',
  params: ['0x341af4de...', 'latest']
});

eth_getTransactionCount​

Returns the current nonce for an address. Proxied to Tezlink.

await window.ethereum.request({
  method: 'eth_getTransactionCount',
  params: ['0x341af4de...', 'latest']
});

eth_call​

Read-only call against an EVM contract. Proxied to Tezlink.

await window.ethereum.request({
  method: 'eth_call',
  params: [{ to: '0x...', data: '0x2e64cec1' }, 'latest']
});

eth_sendTransaction​

Routes a transaction through the NAC gateway. Opens Temple for signature and returns a synthetic hash (the real kernel-synthesized hash is resolved lazily — see EIP-1193 → synthetic hash).

const syntheticHash = await window.ethereum.request({
  method: 'eth_sendTransaction',
  params: [{
    to: '0x...',
    data: '0xd09de08a',          // e.g. increment() selector
    value: '0x0',
  }]
});

eth_getTransactionByHash​

Resolves the real kernel-synthesized EVM transaction when called with a synthetic hash returned by eth_sendTransaction. Falls back to a Tezlink proxy for any other hash.

await window.ethereum.request({
  method: 'eth_getTransactionByHash',
  params: [syntheticHash]
});
// → { hash: '0xrealHash', from, to, blockNumber, ... }

eth_getTransactionReceipt​

Resolves the real receipt (with real logs, gasUsed, blockNumber) by scanning EVM blocks from the send-time snapshot onward. Returns a synthetic receipt after timeout if nothing matches.

await window.ethereum.request({
  method: 'eth_getTransactionReceipt',
  params: [syntheticHash]
});

wallet_revokePermissions / wallet_disconnect​

Disconnects the Temple session and clears all pending op mappings.

await window.ethereum.request({ method: 'wallet_revokePermissions' });

RPC proxy (fallback)​

Any JSON-RPC method not listed above is forwarded transparently to the Tezlink EVM node. This unblocks ethers.js tx.wait(), viem, wagmi and any other library that relies on methods like eth_blockNumber, eth_getBlockByNumber, eth_gasPrice, eth_estimateGas, eth_getCode, eth_getLogs, eth_feeHistory, etc.

await window.ethereum.request({ method: 'eth_blockNumber' });
await window.ethereum.request({
  method: 'eth_getLogs',
  params: [{ address: '0x...', fromBlock: '0x0', toBlock: 'latest' }]
});

Events​

window.ethereum.on('accountsChanged', (accounts) => { /* ... */ });
window.ethereum.on('chainChanged',    (chainId)  => { /* ... */ });
window.ethereum.on('connect',         (info)     => { /* { chainId } */ });
window.ethereum.on('disconnect',      (err)      => { /* EIP-1193 error */ });

Not supported​

MethodReason
eth_signOut of scope for V1
personal_signSIWE / EIP-4361 — requires kernel ERC-1271 (planned 0.3.0)
eth_signTypedData / _v3 / _v4EIP-712 — out of scope for V1