---
slug: /use/deeplinks
---

# Deep Links

Lethean uses the `lthn://` URI scheme for deep linking into wallet applications. This allows websites, apps, and QR codes to trigger wallet actions.

### URI Scheme

```
lthn://transfer/?address=ADDRESS&amount=AMOUNT&asset_id=ASSET_ID&comment=COMMENT
```

### Parameters

| Parameter | Required | Description |
|-----------|----------|-------------|
| `address` | Yes | Recipient address (starts with `iTHN`) |
| `amount` | No | Amount to send (decimal, e.g. `10.5`) |
| `asset_id` | No | Asset ID for custom tokens (omit for native LTHN) |
| `comment` | No | Payment comment (URL-encoded) |

### Examples

**Send 1 LTHN:**
```
lthn://transfer/?address=iTHNUNiuu3VP1yy8xH2y5iQaABKXurdjqZmzFiBiyR4dKG3j6534e9jMriY6SM7PH8NibVwVWW1DWJfQEWnSjS8n3Wgx86pQpY&amount=1
```

**Send with comment:**
```
lthn://transfer/?address=iTHNUNiuu3VP1yy8xH2y5iQaABKXurdjqZmzFiBiyR4dKG3j6534e9jMriY6SM7PH8NibVwVWW1DWJfQEWnSjS8n3Wgx86pQpY&amount=0.5&comment=VPN%20subscription
```

### HTML Usage

```html
<a href="lthn://transfer/?address=iTHNUNiuu3VP1yy8xH2y5iQaABKXurdjqZmzFiBiyR4dKG3j6534e9jMriY6SM7PH8NibVwVWW1DWJfQEWnSjS8n3Wgx86pQpY&amount=1&comment=Donation">
  Pay 1 LTHN
</a>
```

### Implementation

The `lthn://` scheme is handled by:
- **Desktop wallet** (Lethean Desktop) — registered as system URL handler
- **Browser extension** ([Lethean Companion](https://explorer.lthn.io)) — intercepts `lthn://` links in web pages
- **Mobile wallet** (React Native) — registered as app deep link

The [companion test suite](https://github.com/lethean-io) can be used to test deep link generation.

### Domains

| Domain | Purpose |
|--------|---------|
| `.lthn` | Handshake TLD — agent federation identities |
| `lt.hn` | Short URL domain |
| `lethean.io` | Primary website |
| `lthn.sh` | Lab/testnet services |
