Open Wallet (tx.steer.fun)

Generate a link the user opens in their browser. The page shows the request, prompts them to connect their wallet, switches to the requested chainId, then executes the JSON-RPC request.

Build The Link

Base URL:

INLINECODE0

Query params:

• - method: JSON-RPC method name.
• INLINECODE2: integer chain id to execute on (the app will switch chains before execution).
• INLINECODE3: URL-encoded JSON (either an object or an array).
• INLINECODE4 (optional): where to redirect after success/failure with the result.

redirect_url modes:

• - Default: the app appends resultType/result (or error) query params to redirect_url.
• Template mode: if redirect_url contains {{...}}, the app replaces placeholders instead of appending query params.

Notes:

• - If params is a JSON array, it is treated as the exact JSON-RPC params array.
• If params is a JSON object, the app will map it to common method shapes (e.g. fill from from the connected wallet when possible).
• Avoid double-encoding: params should be encoded exactly once (e.g. encodeURIComponent(JSON.stringify(params))). If you see %2522 in the URL, it was encoded twice.

Common Flows

Sign A Message (personal_sign)

Use a JSON object:

CODEBLOCK0

Expected result: signature string.

Send A Transaction (eth_sendTransaction)

Use a JSON object (the app will set from from the connected wallet if omitted):

CODEBLOCK1

Expected result: tx hash.

Typed Data Sign (ethsignTypedDatav4)

Provide { address, typedData }:

CODEBLOCK2

Expected result: signature string.

Batch Calls (wallet_sendCalls)

Provide { calls: [{ to, data }, ...] } (and optionally from):

CODEBLOCK3

Expected result: wallet-dependent (often an id or tx hash).

Getting The Result Back

Option A: No redirect_url (manual copy)

If you omit redirect_url, the page shows a copyable response (or error) after execution.

In your message to the user, ask them to paste back:

• - the tx hash / signature string, or
• the full JSON response (if it returns an object).

Option B: redirect_url (automatic return)

If you include redirect_url, the app redirects after success or failure.

It appends query params (default mode):

• - On success:

• - On failure:

Template mode (no bridge, good for messaging apps):

• - If redirect_url contains {{...}}, placeholders are replaced and no query params are appended.
• Placeholders:

Implementation note for agents:

• - Consider generating a “compose draft” deep link into your chat with the user and using that as redirect_url so, after approval, the user lands in a pre-filled message back to you containing the result.

Example (Telegram share):

Note: Telegram's share endpoint works best when you include both url= and text=. If you omit url=, it may redirect to telegram.org instead of showing the share UI.

CODEBLOCK4

Safety Checks

• - Always show the user what the request does in plain language (what contract, what function, what chain, what value) before asking them to open the link.
• Prefer least-privilege requests; avoid requesting permissions you do not need.