Skip to content

Send files directly between devices over the internet - no cloud storage, no size limits.

Add relay fallback for symmetric NAT transfers (#52)

Denis Lupookov67d032c03f9f
diff --git a/.github/workflows/release-desktop.yml b/.github/workflows/release-desktop.yml
index 3d2c8a8..94fa9e7 100644
--- a/.github/workflows/release-desktop.yml
+++ b/.github/workflows/release-desktop.yml
@@ -25,6 +25,7 @@ jobs:
run: npm run build -w apps/desktop
env:
SENTRY_DSN: ${{ secrets.SENTRY_DSN }}
+ RELAY_CONF_PUBKEY_HEX: ${{ secrets.RELAY_CONF_PUBKEY_HEX }}
VITE_SENTRY_DSN: ${{ secrets.SENTRY_DSN }}
VITE_DISCORD_WEBHOOK_URL: ${{ secrets.DISCORD_WEBHOOK_URL }}
@@ -104,6 +105,7 @@ jobs:
run: npm run build -w apps/desktop
env:
SENTRY_DSN: ${{ secrets.SENTRY_DSN }}
+ RELAY_CONF_PUBKEY_HEX: ${{ secrets.RELAY_CONF_PUBKEY_HEX }}
VITE_SENTRY_DSN: ${{ secrets.SENTRY_DSN }}
VITE_DISCORD_WEBHOOK_URL: ${{ secrets.DISCORD_WEBHOOK_URL }}
@@ -198,6 +200,7 @@ jobs:
run: npm run build -w apps/desktop
env:
SENTRY_DSN: ${{ secrets.SENTRY_DSN }}
+ RELAY_CONF_PUBKEY_HEX: ${{ secrets.RELAY_CONF_PUBKEY_HEX }}
VITE_SENTRY_DSN: ${{ secrets.SENTRY_DSN }}
VITE_DISCORD_WEBHOOK_URL: ${{ secrets.DISCORD_WEBHOOK_URL }}
@@ -230,6 +233,7 @@ jobs:
run: npm run build -w apps/desktop
env:
SENTRY_DSN: ${{ secrets.SENTRY_DSN }}
+ RELAY_CONF_PUBKEY_HEX: ${{ secrets.RELAY_CONF_PUBKEY_HEX }}
VITE_SENTRY_DSN: ${{ secrets.SENTRY_DSN }}
VITE_DISCORD_WEBHOOK_URL: ${{ secrets.DISCORD_WEBHOOK_URL }}
diff --git a/.gitignore b/.gitignore
index c813887..4b1def3 100644
--- a/.gitignore
+++ b/.gitignore
@@ -59,6 +59,7 @@ release
apps/desktop/dist
apps/desktop/out
apps/desktop/src/electron/sentry-dsn.gen.ts
+apps/desktop/src/electron/relay-conf-pubkey.gen.ts
apps/mobile/ios
apps/mobile/android
diff --git a/README.md b/README.md
index 10df0d4..49e668e 100644
--- a/README.md
+++ b/README.md
@@ -6,7 +6,7 @@
### File transfer without the cloud storage.
-Files go directly between your devices — end-to-end encrypted, no accounts, no servers, no limits.
+Files go directly between your devices — end-to-end encrypted, no accounts, nothing stored, no limits.
[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
[![Platforms](https://img.shields.io/badge/platforms-macOS%20%7C%20Windows%20%7C%20Linux%20%7C%20iOS%20%7C%20Android-lightgrey)](#download)
@@ -54,7 +54,7 @@ Why use WeTransfer, Dropbox, or Google Drive when you can send files directly
## Features
- **No accounts** — no signup, no login, no email address required
-- **No servers** — files transfer directly device-to-device, nothing stored in the cloud
+- **No cloud storage** — files go directly between devices; nothing is ever uploaded or stored on a server
- **End-to-end encrypted** — only your devices can read your files, always
- **No file size limit** — send a 100 MB photo or 500 GB video archive, same experience
- **Pair your devices** — pair a device once, then send to it without scanning or typing a code each time
@@ -95,7 +95,7 @@ brew install --cask altersend
```
┌─────────┐ encrypted P2P ┌─────────┐
│ Device │ ◄──────────────────────────────► │ Device │
- │ A │ direct, no middleman │ B │
+ │ A │ direct & encrypted │ B │
└─────────┘ └─────────┘
▲ ▲
│ peer discovery via Hyperswarm │
@@ -109,8 +109,8 @@ AlterSend is built on [Hyperswarm](https://github.com/holepunchto/hyperswarm), a
1. **A random 32-byte key is generated** for each transfer (`crypto.randomBytes(32)`). That 64-char hex string _is_ the join code you share.
2. **Peers rendezvous on a hash of that key, not the key itself.** Both sides compute the same discovery key — a BLAKE2b hash derived from the join code — and join the DHT on that. The raw key never leaves your device, only its hash is published.
-3. **Public bootstrap nodes are the only entry point.** A handful of them get peers onto the DHT. After that, no central server is involved — and there's no relay fallback, so if direct hole-punching fails, the connection fails.
-4. **The connection is direct and end-to-end encrypted.** Peers connect over a Noise-encrypted socket, and the sender shares its [Hyperdrive](https://github.com/holepunchto/hyperdrive) key over that channel. Files are imported into the sender's local Hyperdrive, replicated to the receiver's, then written out to disk — so in v1 each side needs roughly **2× the transfer size** in free space while a transfer runs. _(Working to improve this.)_
+3. **Public bootstrap nodes are the only entry point.** A handful of them get peers onto the DHT. After that, no central server is involved in discovery. Most transfers are direct peer-to-peer; when a direct connection can't be established — usually because both peers are behind symmetric NAT (for example both on a VPN) — the transfer falls back to a **relay** that forwards the already-encrypted stream between them without ever seeing file contents. It's on by default and can be turned off in Settings → Relay.
+4. **The connection is end-to-end encrypted.** Peers connect over a Noise-encrypted socket, and the sender shares its [Hyperdrive](https://github.com/holepunchto/hyperdrive) key over that channel. Files are imported into the sender's local Hyperdrive, replicated to the receiver's, then written out to disk — so in v1 each side needs roughly **2× the transfer size** in free space while a transfer runs. _(Working to improve this.)_
**Pair once, skip the code.** You can pair devices you own so future transfers go straight through — no code to scan or type. Pairing only stores a public device key, the secret stays in your OS keychain, and a paired device is recognized without exposing your identity to anyone else. See [docs/architecture.md](docs/architecture.md#remembered-devices--pairing) for the full design.
@@ -133,20 +133,19 @@ npm install
cp apps/desktop/.env.example apps/desktop/.env
cp apps/mobile/.env.example apps/mobile/.env
-# All env vars are optional in dev — the app runs without them.
```
### Run
```sh
-npm run dev # desktop (Electron)
-npm run mobile:start # mobile (Expo)
+npm run dev
+npm run mobile:start
```
### Build
```sh
-npm run desktop:build # packages + desktop app
+npm run desktop:build
```
Platform installers (`.dmg`, `.exe`, `.AppImage`) are produced by the release CI workflow — trigger manually from the Actions tab.
diff --git a/apps/desktop/.env.example b/apps/desktop/.env.example
index c32d989..a7322c6 100644
--- a/apps/desktop/.env.example
+++ b/apps/desktop/.env.example
@@ -8,3 +8,5 @@ VITE_SENTRY_DSN=
# Discord webhook URL for in-app feedback submissions (optional)
# Must be prefixed VITE_ to be exposed to the renderer via import.meta.env
VITE_DISCORD_WEBHOOK_URL=
+
+RELAY_CONF_PUBKEY_HEX=
diff --git a/apps/desktop/package.json b/apps/desktop/package.json
index 9d21358..24c7ec3 100644
--- a/apps/desktop/package.json
+++ b/apps/desktop/package.json
@@ -10,8 +10,8 @@
"main": "dist/electron/main.js",
"private": true,
"scripts": {
- "build": "node scripts/gen-sentry-dsn.cjs && tsc -p src/tsconfig.electron.json && node scripts/copy-preload.cjs && vite build",
- "build:electron": "node scripts/gen-sentry-dsn.cjs && tsc -p src/tsconfig.electron.json",
+ "build": "node scripts/gen-env.cjs && tsc -p src/tsconfig.electron.json && node scripts/copy-preload.cjs && vite build",
+ "build:electron": "node scripts/gen-env.cjs && tsc -p src/tsconfig.electron.json",
"build:renderer": "vite build",
"typecheck": "tsc --noEmit -p src/tsconfig.electron.json && tsc --noEmit -p tsconfig.json",
"start": "npm run build && electron-forge start -- --no-updates",
@@ -71,6 +71,7 @@
"@types/react-dom": "^19.2.3",
"@vitejs/plugin-react": "^5.2.0",
"app-builder-lib": "^26.8.1",
+ "dotenv": "^16.6.1",
"electron": "^40.2.1",
"electron-builder": "^26.8.1",
"pear-build": "^1.1.0",
diff --git a/apps/desktop/scripts/gen-env.cjs b/apps/desktop/scripts/gen-env.cjs
new file mode 100644
index 0000000..5ed7277
--- /dev/null
+++ b/apps/desktop/scripts/gen-env.cjs
@@ -0,0 +1,14 @@
+const fs = require('fs')
+const path = require('path')
+require('dotenv').config({ path: path.join(__dirname, '../.env') })
+
+const outDir = path.join(__dirname, '../src/electron')
+const GENERATED = [
+ { name: 'SENTRY_DSN', file: 'sentry-dsn.gen.ts' },
+ { name: 'RELAY_CONF_PUBKEY_HEX', file: 'relay-conf-pubkey.gen.ts' }
+]
+
+for (const { name, file } of GENERATED) {
+ const value = process.env[name] ?? ''
+ fs.writeFileSync(path.join(outDir, file), `export const ${name} = ${JSON.stringify(value)};\n`)
+}
diff --git a/apps/desktop/scripts/gen-sentry-dsn.cjs b/apps/desktop/scripts/gen-sentry-dsn.cjs
deleted file mode 100644
index 8fcc673..0000000
--- a/apps/desktop/scripts/gen-sentry-dsn.cjs
+++ /dev/null
@@ -1,6 +0,0 @@
-#!/usr/bin/env node
-const fs = require('fs')
-const path = require('path')
-const dsn = process.env.SENTRY_DSN ?? ''
-const out = path.join(__dirname, '../src/electron/sentry-dsn.gen.ts')
-fs.writeFileSync(out, `export const SENTRY_DSN = '${dsn}';\n`)
diff --git a/apps/desktop/src/electron/runtime.ts b/apps/desktop/src/electron/runtime.ts
index 15f9576..d7838f7 100644
--- a/apps/desktop/src/electron/runtime.ts
+++ b/apps/desktop/src/electron/runtime.ts
@@ -14,6 +14,7 @@ import { isMac, isLinux, isWindows } from 'which-runtime'
import { command, flag, sloppy } from 'paparam'
import { createRequire } from 'module'
import { getAppPath, getWorkerClientPath, getWorkerEntryPath } from './workerPaths.js'
+import { RELAY_CONF_PUBKEY_HEX } from './relay-conf-pubkey.gen.js'
const __filename = fileURLToPath(import.meta.url)
const __dirname = path.dirname(__filename)
@@ -155,6 +156,7 @@ function appDataDir(name: string): string {
export function createDesktopRuntime({ broadcast }: { broadcast: Broadcast }): DesktopRuntime {
const workers = new Map<string, WorkerRuntime>()
let pear: PearRuntimeInstance | null = null
+ let rememberedRelayConfig: Parameters<WorkerClient['setRelayConfig']>[0] | null = null
function getPear() {
if (pear) return pear
@@ -206,6 +208,8 @@ export function createDesktopRuntime({ broadcast }: { broadcast: Broadcast }): D
`--storage=${pear.storage}`,
`--identity=${identityRoot}`,
'--device-type=desktop',
+ ...(RELAY_CONF_PUBKEY_HEX ? [`--relay-conf-pubkey=${RELAY_CONF_PUBKEY_HEX}`] : []),
+ ...cliArgs.filter((arg) => arg.startsWith('--relay-')),
...args
])
const client = createTransferWorkerClient(worker, {
@@ -220,6 +224,15 @@ export function createDesktopRuntime({ broadcast }: { broadcast: Broadcast }): D
ready: client.ready
}
+ if (rememberedRelayConfig) {
+ const cfg = rememberedRelayConfig
+ runtime.ready
+ .then(() => runtime.client.setRelayConfig(cfg))
+ .catch((err) =>
+ console.error('[relay] re-applying relay config on worker respawn failed', err)
+ )
+ }
+
function sendWorkerStdout(data: unknown) {
process.stdout.write(`[worker:${specifier}] ${String(data)}`)
broadcast('pear:worker:stdout:' + specifier, data)
@@ -272,6 +285,9 @@ export function createDesktopRuntime({ broadcast }: { broadcast: Broadcast }): D
}
const runtime = getWorker(specifier)
+ if (method === 'setRelayConfig') {
+ rememberedRelayConfig = args[0] as typeof rememberedRelayConfig
+ }
return (runtime.client[method] as (...a: unknown[]) => Promise<unknown>)(...args)
}
diff --git a/apps/desktop/src/renderer/components/Settings/index.tsx b/apps/desktop/src/renderer/components/Settings/index.tsx
index 4041db9..d13459f 100644
--- a/apps/desktop/src/renderer/components/Settings/index.tsx
+++ b/apps/desktop/src/renderer/components/Settings/index.tsx
@@ -5,6 +5,7 @@ import {
LaptopIcon,
MailIcon,
ShieldIcon,
+ WaypointsIcon,
type IconProps
} from '@altersend/components/icons'
import { loadPeers } from '@altersend/domain'
@@ -13,6 +14,7 @@ import { Modal } from '../Modal'
import { ListItem } from '@altersend/components'
import { DevicesSection } from './sections/DevicesSection'
import { LanguageSection } from './sections/LanguageSection'
+import { ConnectionSection } from './sections/ConnectionSection'
import { FeedbackSection } from './sections/FeedbackSection'
import { SecuritySection } from './sections/SecuritySection'
import { AboutSection } from './sections/AboutSection'
@@ -23,8 +25,9 @@ export { openSettingsPanel } from './settingsControl'
const NAV: { id: SettingsSection; icon: ComponentType<IconProps>; labelKey: string }[] = [
{ id: 'devices', icon: LaptopIcon, labelKey: 'settings:pairing.pairedDevices' },
{ id: 'language', icon: GlobeIcon, labelKey: 'settings:languageTitle' },
- { id: 'feedback', icon: MailIcon, labelKey: 'settings:rows.feedback' },
+ { id: 'connection', icon: WaypointsIcon, labelKey: 'settings:rows.connection' },
{ id: 'security', icon: ShieldIcon, labelKey: 'settings:rows.security' },
+ { id: 'feedback', icon: MailIcon, labelKey: 'settings:rows.feedback' },
{ id: 'about', icon: InfoIcon, labelKey: 'settings:sections.about' }
]
@@ -66,6 +69,8 @@ export function Settings({ version }: { version: string }) {
<DevicesSection />
) : section === 'language' ? (
<LanguageSection />
+ ) : section === 'connection' ? (
+ <ConnectionSection />
) : section === 'feedback' ? (
<FeedbackSection version={version} />
) : section === 'security' ? (
diff --git a/apps/desktop/src/renderer/components/Settings/sections/ConnectionSection.tsx b/apps/desktop/src/renderer/components/Settings/sections/ConnectionSection.tsx
new file mode 100644
index 0000000..55e9aa0
--- /dev/null
+++ b/apps/desktop/src/renderer/components/Settings/sections/ConnectionSection.tsx
@@ -0,0 +1,38 @@
+import { useState } from 'react'
+import { ExternalLink, ToggleSwitch } from '@altersend/components'
+import { useTranslation } from '@altersend/locales'
+import { websiteUrl } from '@altersend/domain'
+import { bridgeApi } from '../../../api/bridgeApi'
+import { isRelayEnabled, setRelayEnabledStorage } from '../../../lifecycle/relayStorage'
+import { SectionShell } from './SectionShell'
+
+export function ConnectionSection() {
+ const { t } = useTranslation(['settings'])
+ const [relay, setRelay] = useState(isRelayEnabled)
+
+ const handleRelayToggle = (next: boolean) => {
+ setRelay(next)
+ setRelayEnabledStorage(next)
+ bridgeApi.worker.setRelayConfig({ enabled: next }).catch(() => {
+ setRelay(!next)
+ setRelayEnabledStorage(!next)
+ })
+ }
+
+ return (
+ <SectionShell title={t('settings:rows.connection')}>
+ <ToggleSwitch
+ checked={relay}
+ onChange={handleRelayToggle}
+ label={t('settings:relay.label')}
+ description={t('settings:relay.description')}
+ />
+ <p className='m-0 mt-5 text-[12px] leading-5 text-text-muted'>
+ {t('settings:relay.fairUse')} {t('settings:relay.contact')}{' '}
+ <ExternalLink onPress={() => bridgeApi.openExternalUrl(websiteUrl).catch(() => {})}>
+ {t('settings:rows.contact')}
+ </ExternalLink>
+ </p>
+ </SectionShell>
+ )
+}
diff --git a/apps/desktop/src/renderer/components/Settings/settingsControl.ts b/apps/desktop/src/renderer/components/Settings/settingsControl.ts
index d9f77e7..b5c05f2 100644
--- a/apps/desktop/src/renderer/components/Settings/settingsControl.ts
+++ b/apps/desktop/src/renderer/components/Settings/settingsControl.ts
@@ -1,4 +1,10 @@
-export type SettingsSection = 'devices' | 'language' | 'feedback' | 'security' | 'about'
+export type SettingsSection =
+ | 'devices'
+ | 'language'
+ | 'connection'
+ | 'feedback'
+ | 'security'
+ | 'about'
type Listener = (section: SettingsSection) => void
diff --git a/apps/desktop/src/renderer/lifecycle/relayStorage.ts b/apps/desktop/src/renderer/lifecycle/relayStorage.ts
new file mode 100644
index 0000000..75a7212
--- /dev/null
+++ b/apps/desktop/src/renderer/lifecycle/relayStorage.ts
@@ -0,0 +1,16 @@
+const KEY = 'altersend.relay.enabled'
+
+export function isRelayEnabled(): boolean {
+ try {
+ const value = window.localStorage.getItem(KEY)
+ return value === null ? true : value === '1'
+ } catch {
+ return true
+ }
+}
+
+export function setRelayEnabledStorage(value: boolean): void {
+ try {
+ window.localStorage.setItem(KEY, value ? '1' : '0')
+ } catch {}
+}
diff --git a/apps/desktop/src/renderer/main.tsx b/apps/desktop/src/renderer/main.tsx
index fbc2181..d698bae 100644
--- a/apps/desktop/src/renderer/main.tsx
+++ b/apps/desktop/src/renderer/main.tsx
@@ -18,6 +18,7 @@ import { bridgeApi, hasBridge } from './api/bridgeApi'
import { startDeepLinkHandler } from './lifecycle/deepLinkHandler'
import { initSentry, captureException } from './sentry'
import { isCrashReportingEnabled } from './lifecycle/crashReportingStorage'
+import { isRelayEnabled } from './lifecycle/relayStorage'
import { getSavedLocalePreference } from './lifecycle/localePreferenceStorage'
import { getDesktopSystemLocales } from './lifecycle/systemLocale'
import './strict.css'
@@ -65,6 +66,9 @@ if (hasBridge()) {
bindTransferApi(bridgeApi, {
onError: (context, error) => captureException(error, context)
})
+ bridgeApi.worker
+ .setRelayConfig({ enabled: isRelayEnabled() })
+ .catch((err) => captureException(err, 'setRelayConfig'))
startPeerWatchdog()
startBackgroundReconnectEffect()
startDeepLinkHandler()
diff --git a/apps/desktop/src/renderer/pages/ReceivePage/index.tsx b/apps/desktop/src/renderer/pages/ReceivePage/index.tsx
index 0ff2daf..d35ab06 100644
--- a/apps/desktop/src/renderer/pages/ReceivePage/index.tsx
+++ b/apps/desktop/src/renderer/pages/ReceivePage/index.tsx
@@ -1,7 +1,9 @@
import { useMemo } from 'react'
import { Button } from '@altersend/components'
+import { InfoIcon } from '@altersend/components/icons'
import { useTranslation } from '@altersend/locales'
import { TransferStatusPanel, TransferCardFrame } from '../../components'
+import { openSettingsPanel } from '../../components/Settings'
import { ReceiveCompleteView } from './ReceiveCompleteView'
import { ReceiveConnectedView } from './ReceiveConnectedView'
import { ReceiveDisconnectedView } from './ReceiveDisconnectedView'
@@ -22,6 +24,7 @@ export default function ReceivePage() {
const incomingFileOffers = useTransferStore((s) => s.incomingFileOffers)
const receiveDownloadStates = useTransferStore((s) => s.receiveDownloadStates)
const peerCount = useTransferStore((s) => s.peerCount)
+ const connectionType = useTransferStore((s) => s.connectionType)
const hasIncomingFiles = incomingFileOffers.length > 0
const totals = useMemo(
@@ -48,11 +51,18 @@ export default function ReceivePage() {
totals.totalBytes
)
+ const isRelay = connectionType === 'relay'
const connectedBadge =
isConnectedStep(step) && step !== 'completed' && step !== 'interrupted' ? (
- <div className='inline-flex items-center gap-1.5 rounded-full bg-success/12 px-2.5 py-1 text-[12px] font-semibold text-success'>
+ <div
+ onClick={isRelay ? () => openSettingsPanel('connection') : undefined}
+ className={`inline-flex items-center gap-1.5 rounded-full bg-success/12 px-2.5 py-1 text-[12px] font-semibold text-success ${
+ isRelay ? 'cursor-pointer transition-opacity hover:opacity-80' : ''
+ }`}
+ >
<span className='h-2 w-2 shrink-0 rounded-full bg-success' />
- {t('common:status.connected')}
+ {isRelay ? t('common:status.connectedViaRelay') : t('common:status.connected')}
+ {isRelay ? <InfoIcon size={13} /> : null}
</div>
) : undefined
diff --git a/apps/mobile/.env.example b/apps/mobile/.env.example
index 6831bd0..3d78bb9 100644
--- a/apps/mobile/.env.example
+++ b/apps/mobile/.env.example
@@ -1,2 +1,4 @@
# Sentry DSN — EXPO_PUBLIC_ prefix makes it available at runtime via process.env
EXPO_PUBLIC_SENTRY_DSN=
+
+EXPO_PUBLIC_RELAY_CONF_PUBKEY=
diff --git a/apps/mobile/app/_layout.tsx b/apps/mobile/app/_layout.tsx
index 6836c99..5bd907b 100644
--- a/apps/mobile/app/_layout.tsx
+++ b/apps/mobile/app/_layout.tsx
@@ -34,6 +34,7 @@ import { useAlterSendFonts } from '../src/theme/useAlterSendFonts'
import { startAppStateBridge } from '../src/lifecycle/appStateBridge'
import { startDeepLinkHandler } from '../src/lifecycle/deepLinkHandler'
import { getSavedLocalePreference } from '../src/lifecycle/localePreferenceStorage'
+import { isRelayEnabled } from '../src/lifecycle/relayStorage'
import { getMobileSystemLocales } from '../src/lifecycle/systemLocale'
import { ShareIntentHandler } from '../src/lifecycle/ShareIntentHandler'
import { startPhotosCopyEffect } from '../src/transfer/receive'
@@ -45,6 +46,9 @@ initSentry()
bindTransferApi(mobileApi, {
onError: (context, error) => captureException(error, context)
})
+mobileApi.worker
+ .setRelayConfig({ enabled: isRelayEnabled() })
+ .catch((err) => captureException(err, 'setRelayConfig'))
startAppStateBridge()
startPeerWatchdog()
startBackgroundReconnectEffect()
@@ -92,6 +96,7 @@ function ThemedStack() {
<Stack.Screen name='onboarding' options={{ headerShown: false, gestureEnabled: false }} />
<Stack.Screen name='settings' options={flowScreenOptions} />
<Stack.Screen name='language' options={flowScreenOptions} />
+ <Stack.Screen name='connection' options={flowScreenOptions} />
<Stack.Screen name='security' options={flowScreenOptions} />
<Stack.Screen name='devices' options={flowScreenOptions} />
<Stack.Screen name='about' options={flowScreenOptions} />
diff --git a/apps/mobile/app/connection.tsx b/apps/mobile/app/connection.tsx
new file mode 100644
index 0000000..b2f9b3e
--- /dev/null
+++ b/apps/mobile/app/connection.tsx
@@ -0,0 +1,70 @@
+import { Linking, StyleSheet, View } from 'react-native'
+import { useState } from 'react'
+import { ExternalLink, ToggleSwitch, useTheme } from '@altersend/components'
+import { useTranslation } from '@altersend/locales'
+import { websiteUrl } from '@altersend/domain'
+import { Layout } from '@/src/components'
+import { Text } from '@/src/components/ThemedText'
+import { isRelayEnabled, setRelayEnabledStorage } from '@/src/lifecycle/relayStorage'
+import { mobileApi } from '@/src/api/mobileApi'
+
+export default function ConnectionScreen() {
+ const { t } = useTranslation(['settings'])
+ const { theme } = useTheme()
+ const [relay, setRelay] = useState(isRelayEnabled)
+
+ const handleRelayToggle = (value: boolean) => {
+ setRelay(value)
+ setRelayEnabledStorage(value)
+ mobileApi.worker.setRelayConfig({ enabled: value }).catch(() => {
+ setRelay(!value)
+ setRelayEnabledStorage(!value)
+ })
+ }
+
+ const cardStyle = {
+ backgroundColor: theme.colors.colorBackgroundSubtle,
+ borderColor: theme.colors.colorBorderPrimary
+ }
+
+ return (
+ <Layout title={t('settings:rows.connection')} description='' hasNativeHeader>
+ <View style={[styles.card, styles.cardPad, cardStyle]}>
+ <ToggleSwitch
+ checked={relay}
+ onChange={handleRelayToggle}
+ label={t('settings:relay.label')}
+ description={t('settings:relay.description')}
+ />
+ </View>
+ <View style={styles.info}>
+ <Text style={[styles.infoLine, { color: theme.colors.colorTextMuted }]}>
+ {t('settings:relay.fairUse')} {t('settings:relay.contact')}
+ </Text>
+ <ExternalLink href={websiteUrl} onPress={() => Linking.openURL(websiteUrl).catch(() => {})}>
+ {t('settings:rows.contact')}
+ </ExternalLink>
+ </View>
+ </Layout>
+ )
+}
+
+const styles = StyleSheet.create({
+ card: {
+ borderRadius: 16,
+ borderWidth: 1,
+ overflow: 'hidden'
+ },
+ cardPad: {
+ paddingHorizontal: 16,
+ paddingVertical: 13
+ },
+ info: {
+ marginTop: 16,
+ gap: 6
+ },
+ infoLine: {
+ fontSize: 13,
+ lineHeight: 19
+ }
+})
diff --git a/apps/mobile/app/receive/incoming.tsx b/apps/mobile/app/receive/incoming.tsx
index 6388e23..9be84cd 100644
--- a/apps/mobile/app/receive/incoming.tsx
+++ b/apps/mobile/app/receive/incoming.tsx
@@ -2,7 +2,7 @@ import { useCallback, useEffect, useMemo } from 'react'
import { View, StyleSheet, Pressable } from 'react-native'
import { Paths } from 'expo-file-system'
import { Button, useTheme } from '@altersend/components'
-import { ArrowLeftIcon, DownloadIcon } from '@altersend/components/icons'
+import { ArrowLeftIcon, DownloadIcon, InfoIcon } from '@altersend/components/icons'
import { useTranslation } from '@altersend/locales'
import { useNavigation, useRouter } from 'expo-router'
import { uriToPath } from '@/src/api/mobileApi'
@@ -30,6 +30,7 @@ export default function ReceiveIncomingScreen() {
const receiveDownloadStates = useTransferStore((s) => s.receiveDownloadStates)
const role = useTransferStore((s) => s.role)
const peerCount = useTransferStore((s) => s.peerCount)
+ const connectionType = useTransferStore((s) => s.connectionType)
const isReconnecting = useTransferStore((s) => s.isReconnecting)
const errorCode = useTransferStore((s) => s.errorCode)
const displayError = getDisplayError(t, errorCode)
@@ -146,7 +147,24 @@ export default function ReceiveIncomingScreen() {
)
}
- const badge = (
+ const isRelay = connectionType === 'relay'
+ const badge = isRelay ? (
+ <Pressable
+ accessibilityRole='button'
+ accessibilityLabel={t('common:status.connectedViaRelay')}
+ onPress={() => router.push('/connection')}
+ style={({ pressed }) => [
+ styles.badge,
+ { backgroundColor: theme.colors.colorSuccessSubtle, opacity: pressed ? 0.7 : 1 }
+ ]}
+ >
+ <View style={[styles.badgeDot, { backgroundColor: theme.colors.colorSuccess }]} />
+ <Text style={[styles.badgeText, { color: theme.colors.colorSuccess }]}>
+ {t('common:status.connectedViaRelay')}
+ </Text>
+ <InfoIcon size={13} color={theme.colors.colorSuccess} />
+ </Pressable>
+ ) : (
<View style={[styles.badge, { backgroundColor: theme.colors.colorSuccessSubtle }]}>
<View style={[styles.badgeDot, { backgroundColor: theme.colors.colorSuccess }]} />
<Text style={[styles.badgeText, { color: theme.colors.colorSuccess }]}>
diff --git a/apps/mobile/app/settings.tsx b/apps/mobile/app/settings.tsx
index 377dd42..a36dee3 100644
--- a/apps/mobile/app/settings.tsx
+++ b/apps/mobile/app/settings.tsx
@@ -10,7 +10,8 @@ import {
GlobeIcon,
InfoIcon,
ShieldIcon,
- SmartphoneIcon
+ SmartphoneIcon,
+ WaypointsIcon
} from '@altersend/components/icons'
import { Layout } from '@/src/components'
import { Text } from '@/src/components/ThemedText'
@@ -83,6 +84,13 @@ export default function SettingsScreen() {
icon={<GlobeIcon size={16} color={c.colorTextSecondary} />}
onPress={() => router.push('/language')}
/>
+ <LinkRow
+ standalone
+ label={t('settings:rows.connection')}
+ subtitle={t('settings:relay.label')}
+ icon={<WaypointsIcon size={16} color={c.colorTextSecondary} />}
+ onPress={() => router.push('/connection')}
+ />
<LinkRow
standalone
label={t('settings:rows.security')}
diff --git a/apps/mobile/src/api/mobileApi.ts b/apps/mobile/src/api/mobileApi.ts
index 2b8e094..be0ae62 100644
--- a/apps/mobile/src/api/mobileApi.ts
+++ b/apps/mobile/src/api/mobileApi.ts
@@ -12,6 +12,7 @@ import { Directory, Paths } from 'expo-file-system'
import * as SecureStore from 'expo-secure-store'
import { Platform } from 'react-native'
import { Worklet } from 'react-native-bare-kit'
+import { isRelayEnabled } from '../lifecycle/relayStorage'
const STORAGE_ROOT_DIRNAME = 'altersend'
const IDENTITY_ROOT_DIRNAME = 'altersend-identity'
@@ -66,6 +67,10 @@ async function getWorkletArgs() {
if (deviceName) args.push(`--device-name=${deviceName}`)
const isPad = Platform.OS === 'ios' && (Platform as { isPad?: boolean }).isPad === true
args.push(`--device-type=${isPad ? 'tablet' : 'phone'}`)
+ const relayConfPubkey = process.env.EXPO_PUBLIC_RELAY_CONF_PUBKEY?.trim()
+ if (relayConfPubkey) args.push(`--relay-conf-pubkey=${relayConfPubkey}`)
+ if (isRelayEnabled()) args.push('--relay-enabled')
+
return args
}
diff --git a/apps/mobile/src/lifecycle/relayStorage.ts b/apps/mobile/src/lifecycle/relayStorage.ts
new file mode 100644
index 0000000..6da0fb1
--- /dev/null
+++ b/apps/mobile/src/lifecycle/relayStorage.ts
@@ -0,0 +1,35 @@
+import { Directory, File, Paths } from 'expo-file-system'
+
+const DIRNAME = 'altersend'
+const FILENAME = 'relay.disabled'
+
+function getMarkerFile(): File | null {
+ const documentDirectory = Paths.document
+ if (!documentDirectory?.uri) return null
+ return new File(new Directory(documentDirectory, DIRNAME), FILENAME)
+}
+
+export function isRelayEnabled(): boolean {
+ try {
+ return !(getMarkerFile()?.exists ?? false)
+ } catch {
+ return true
+ }
+}
+
+export function setRelayEnabledStorage(value: boolean): void {
+ try {
+ const documentDirectory = Paths.document
+ if (!documentDirectory?.uri) return
+ const dir = new Directory(documentDirectory, DIRNAME)
+ const file = new File(dir, FILENAME)
+ if (value) {
+ if (file.exists) file.delete()
+ } else {
+ if (!dir.exists) dir.create({ idempotent: true, intermediates: true })
+ if (!file.exists) file.create()
+ }
+ } catch (err) {
+ console.warn('relayStorage: setRelayEnabledStorage failed', err)
+ }
+}
diff --git a/docs/architecture.md b/docs/architecture.md
index cc6929f..6ca333b 100644
--- a/docs/architecture.md
+++ b/docs/architecture.md
@@ -57,6 +57,8 @@ Key modules:
- `worklet/transfer/storage.ts` — `TransferStorage`: the ephemeral Corestore + Hyperdrive backing a session, plus the sender/receiver bound to them (wiped on every disconnect)
- `worklet/transfer/sender.ts` — `TransferSender`: stages local files into the writable Hyperdrive (sender path)
- `worklet/transfer/receiver.ts` — `TransferReceiver`: writes replicated remote Hyperdrive contents to disk (receiver path)
+- `worklet/relay/config.ts` — relay enable state + relay list; `relayThrough` (the Hyperswarm fallback callback) and `isRelayHost` (connection-type classification)
+- `worklet/relay/conf.ts` — fetches the relay list from a signed HyperDHT mutable record; loads lazily once the relay is enabled (see [Relay fallback](#relay-fallback))
- `worklet/identity/device-identity-store.ts` — `DeviceIdentityStore`: the stable device keypair, its secret is sealed in the OS keychain and injected at startup (see [Remembered devices & pairing](#remembered-devices--pairing))
- `worklet/peers/store.ts` — `RememberedPeerStore`: persistent (HyperDB) list of paired devices
- `worklet/peers/pairing-coordinator.ts` — `PairingCoordinator`: the dedicated pairing swarm + QR / code pairing handshake
@@ -94,6 +96,16 @@ Shared internationalization package used by desktop and mobile. It owns supporte
4. Sender stages the selected files into its writable Hyperdrive, then broadcasts a `transfer-ready` control message carrying file offers (each with the drive key).
5. Receiver requests the offered files and downloads their blobs from the replicated drive. Progress and completion events flow back over the control channel → RPC → domain reducer → UI.
+## Relay fallback
+
+Most transfers connect directly (P2P hole-punching). When two peers can't reach each other — typically both behind symmetric NAT, e.g. both on a commercial VPN — the transfer falls back to a **blind relay**: a public server that pairs the two peers and forwards their already-encrypted UDX stream. The relay never has the keys to decrypt the data — it relays ciphertext only.
+
+- **Engagement.** `relay/config.ts` exposes `relayThrough` to both swarms (`TransferSwarm`, `DiscoveryCoordinator`). It runs in "eager" mode: when enabled, it always offers the relay, so hyperdht can race a relayed path against a direct hole-punch and upgrade to direct if the punch lands.
+- **Relay discovery (relay-conf).** The relay's public key isn't baked into the app. `relay/conf.ts` reads the current relay list from a signed HyperDHT **mutable record** whose public key ships with the app (`--relay-conf-pubkey`, injected at build time); only the relay operator's secret can update it, so relays rotate with no app release. The list is fetched **lazily** — only once the relay is enabled — with a small bounded retry to survive a cold-start DHT miss. This uses a mutable record (not a hypercore) specifically because the worklet wipes its Corestore on every startup.
+- **Connection-type classification.** `TransferSwarm.classifyConnection` compares a peer socket's `remoteHost` against the known relay hosts (`isRelayHost`) and emits a per-peer `connection-type` (`direct` / `relay`) event. The receiver keys this per sender (`transferPeerKey`) so a mesh of receivers can't cross-contaminate the badge, and the UI shows **Connected** vs **Connected via relay**.
+
+The app is only ever a relay *client* — it holds the relay's **public** key and address (from the relay-conf record) and never any relay secret.
+
## Remembered devices & pairing
Beyond one-off code transfers, you can **pair** devices you own (or trust) so you can send to them later without a code. This lives entirely in the worklet (`packages/core/src/worklet/peers/*` + `identity/`) and is backed by three separate Hyperswarm instances:
diff --git a/knip.json b/knip.json
index 248c131..5d3df7a 100644
--- a/knip.json
+++ b/knip.json
@@ -61,7 +61,8 @@
"app-builder-lib"
],
"ignoreUnresolved": [
- "^\\./sentry-dsn\\.gen\\.js$"
+ "^\\./sentry-dsn\\.gen\\.js$",
+ "^\\./relay-conf-pubkey\\.gen\\.js$"
],
"ignoreBinaries": [
"electron-builder.mac.json",
diff --git a/package-lock.json b/package-lock.json
index b0064f4..f28de20 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -72,6 +72,7 @@
"@types/react-dom": "^19.2.3",
"@vitejs/plugin-react": "^5.2.0",
"app-builder-lib": "^26.8.1",
+ "dotenv": "^16.6.1",
"electron": "^40.2.1",
"electron-builder": "^26.8.1",
"pear-build": "^1.1.0",
@@ -27346,6 +27347,7 @@
"corestore": "^7.9.1",
"hypercore-crypto": "^3.6.1",
"hyperdb": "^6.7.0",
+ "hyperdht": "^6.32.0",
"hyperdrive": "^13.3.0",
"hyperswarm": "^4.17.0",
"localdrive": "^2.2.0",
diff --git a/packages/components/src/icons/set.tsx b/packages/components/src/icons/set.tsx
index 7b7b96c..6fe75b5 100644
--- a/packages/components/src/icons/set.tsx
+++ b/packages/components/src/icons/set.tsx
@@ -50,6 +50,7 @@ import {
Trash2,
Upload,
Video,
+ Waypoints,
X
} from './lucide'
import { adaptLucide } from './adaptLucide'
@@ -106,4 +107,5 @@ export const SmartphoneIcon = adaptLucide(Smartphone)
export const TrashIcon = adaptLucide(Trash2)
export const UploadIcon = adaptLucide(Upload)
export const VideoIcon = adaptLucide(Video)
+export const WaypointsIcon = adaptLucide(Waypoints)
export const CloseIcon = adaptLucide(X)
diff --git a/packages/core/package.json b/packages/core/package.json
index 10d3320..b84767e 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -45,6 +45,7 @@
"corestore": "^7.9.1",
"hypercore-crypto": "^3.6.1",
"hyperdb": "^6.7.0",
+ "hyperdht": "^6.32.0",
"hyperdrive": "^13.3.0",
"hyperswarm": "^4.17.0",
"localdrive": "^2.2.0",
diff --git a/packages/core/src/types.d.ts b/packages/core/src/types.d.ts
index aeca05d..c26ee89 100644
--- a/packages/core/src/types.d.ts
+++ b/packages/core/src/types.d.ts
@@ -128,6 +128,7 @@ declare module 'hyperswarm' {
constructor(opts?: {
keyPair?: NoiseKeyPair
firewall?: (remotePublicKey: Uint8Array) => boolean
+ relayThrough?: ((force: boolean, swarm: unknown) => Uint8Array[] | null) | Uint8Array[] | null
})
join(
discoveryKey: Uint8Array,
@@ -140,6 +141,21 @@ declare module 'hyperswarm' {
}
}
+declare module 'hyperdht' {
+ export interface MutableRecord {
+ seq: number
+ value: Uint8Array
+ signature: Uint8Array
+ }
+ export default class HyperDHT {
+ mutableGet(
+ publicKey: Uint8Array,
+ opts?: { latest?: boolean; seq?: number }
+ ): Promise<MutableRecord | null>
+ destroy(): Promise<void>
+ }
+}
+
declare module 'protomux' {
export interface ProtomuxMessage<T = unknown> {
send(message: T): void
diff --git a/packages/core/src/worklet/index.ts b/packages/core/src/worklet/index.ts
index ea36361..b076a26 100644
--- a/packages/core/src/worklet/index.ts
+++ b/packages/core/src/worklet/index.ts
@@ -14,6 +14,8 @@ import { isDeviceType } from './identity/device-type'
import { createReadyEvent } from './rpc/events'
import { API, encodeRPCPayload } from './rpc/protocol'
import { createTransferWorkerRPCServer } from './rpc/server'
+import { configureRelay } from './relay/config'
+import { startRelayConf, stopRelayConf } from './relay/conf'
function readArg(prefix: string): string | undefined {
const flag = (Bare.argv as string[]).find((arg) => arg.startsWith(prefix))
@@ -66,6 +68,20 @@ const providedName = readArg('--device-name=')?.trim()
const displayName = providedName || os.hostname().replace(/\.local$/, '') || 'AlterSend Device'
const providedType = readArg('--device-type=')
const deviceType = isDeviceType(providedType) ? providedType : undefined
+
+const relayKeyArg = readArg('--relay-key=')?.trim()
+const relayHostArg = readArg('--relay-host=')?.trim() ?? ''
+const relayEnabledArg = (Bare.argv as string[]).includes('--relay-enabled')
+if (relayKeyArg && !relayHostArg) {
+ console.warn('[relay] --relay-key set without --relay-host; connections will classify as direct')
+}
+if (relayKeyArg || relayEnabledArg) {
+ configureRelay({
+ ...(relayKeyArg ? { relays: [{ keyHex: relayKeyArg, host: relayHostArg }] } : {}),
+ enabled: relayEnabledArg || !!relayKeyArg
+ })
+}
+
const orchestrator = new TransferOrchestrator(sendTransferEvent, storageRoot, identityRoot, {
displayName,
deviceType
@@ -74,6 +90,8 @@ const rpc = createTransferWorkerRPCServer(ipc, orchestrator, sendTransferEvent,
orchestrator.abortInFlight()
)
+startRelayConf(readArg('--relay-conf-pubkey='))
+
const originalLog: typeof console.log = console.log
const originalWarn: typeof console.warn = console.warn
const originalError: typeof console.error = console.error
@@ -101,6 +119,11 @@ async function gracefulShutdown(_reason: string) {
} catch (err) {
console.error('Core: orchestrator.destroy failed', err)
}
+ try {
+ await stopRelayConf()
+ } catch (err) {
+ console.error('Core: stopRelayConf failed', err)
+ }
}
function exitProcess() {
diff --git a/packages/core/src/worklet/peers/discovery.ts b/packages/core/src/worklet/peers/discovery.ts
index 62f2f51..eb1a51a 100644
--- a/packages/core/src/worklet/peers/discovery.ts
+++ b/packages/core/src/worklet/peers/discovery.ts
@@ -15,6 +15,7 @@ import {
type TransferIPCMessage
} from '../rpc/events'
import { BadRequestError, type InviteDeviceReply, type InviteResponseReply } from '../rpc/protocol'
+import { relayThrough } from '../relay/config'
export const INVITE_WAIT_MS = 30_000
@@ -27,6 +28,7 @@ export interface DiscoverySwarm {
type CreateDiscoverySwarm = (opts: {
keyPair: NoiseKeyPair
firewall: (remotePublicKey: Uint8Array) => boolean
+ relayThrough: (force: boolean, swarm: unknown) => Uint8Array[] | null
}) => DiscoverySwarm
export interface DiscoveryDeps {
@@ -84,7 +86,8 @@ export class DiscoveryCoordinator {
this.swarm = createSwarm({
keyPair: { publicKey: identity.publicKey, secretKey: identity.secretKey },
firewall: (remotePublicKey) =>
- !this.knownPubkeys.has(normalizeKey(b4a.toString(remotePublicKey, 'hex')))
+ !this.knownPubkeys.has(normalizeKey(b4a.toString(remotePublicKey, 'hex'))),
+ relayThrough
})
this.swarm.on('connection', (socket, info) => {
this.handleConnection(socket, info)
diff --git a/packages/core/src/worklet/relay/conf.ts b/packages/core/src/worklet/relay/conf.ts
new file mode 100644
index 0000000..a038b53
--- /dev/null
+++ b/packages/core/src/worklet/relay/conf.ts
@@ -0,0 +1,108 @@
+import b4a from 'b4a'
+import DHT from 'hyperdht'
+import { configureRelay, registerRelayLoader, relayConfigSummary } from './config'
+import { isValidHexKey } from '../transfer/utils'
+
+const MAX_ATTEMPTS = 3
+const RETRY_DELAY_MS = 5000
+
+let pubkey: Uint8Array | null = null
+let loaded = false
+let inFlight = false
+let activeDht: DHT | null = null
+
+export function startRelayConf(pubkeyHex: string | undefined): void {
+ if (!pubkeyHex || pubkey) return
+
+ pubkey = b4a.from(pubkeyHex, 'hex')
+ registerRelayLoader(() => ensureRelayConf())
+
+ if (relayConfigSummary().enabled) ensureRelayConf()
+}
+
+interface RelayRecordEntry {
+ key: string
+ host: string
+}
+
+function isValidEntry(entry: unknown): entry is RelayRecordEntry {
+ const e = entry as Partial<RelayRecordEntry> | null
+ return (
+ !!e &&
+ typeof e === 'object' &&
+ isValidHexKey(e.key) &&
+ typeof e.host === 'string' &&
+ e.host.length > 0
+ )
+}
+
+const delay = (ms: number) => new Promise<void>((resolve) => setTimeout(resolve, ms))
+
+async function ensureRelayConf(): Promise<void> {
+ if (!pubkey || loaded || inFlight || !relayConfigSummary().enabled) return
+
+ inFlight = true
+ const dht = new DHT()
+ activeDht = dht
+
+ try {
+ for (let attempt = 0; attempt < MAX_ATTEMPTS; attempt++) {
+ if (activeDht !== dht) return
+ if (await tryFetch(dht)) {
+ loaded = true
+ return
+ }
+ if (attempt < MAX_ATTEMPTS - 1) await delay(RETRY_DELAY_MS)
+ }
+ } finally {
+ activeDht = null
+ inFlight = false
+ try {
+ await dht.destroy()
+ } catch (err) {
+ console.warn(
+ '[relay-conf] dht.destroy failed',
+ err instanceof Error ? err.message : String(err)
+ )
+ }
+ }
+}
+
+async function tryFetch(dht: DHT): Promise<boolean> {
+ if (!pubkey) return false
+
+ try {
+ const record = await dht.mutableGet(pubkey, { latest: true })
+ if (!record?.value) return false
+ const parsed = JSON.parse(b4a.toString(record.value, 'utf8')) as { relays?: unknown }
+ if (
+ Array.isArray(parsed.relays) &&
+ parsed.relays.length > 0 &&
+ parsed.relays.every(isValidEntry)
+ ) {
+ const relays = parsed.relays as RelayRecordEntry[]
+ configureRelay({ relays: relays.map((r) => ({ keyHex: r.key, host: r.host })) })
+ return true
+ }
+ } catch (err) {
+ console.warn('[relay-conf] fetch failed', err instanceof Error ? err.message : String(err))
+ }
+
+ return false
+}
+
+export async function stopRelayConf(): Promise<void> {
+ const dht = activeDht
+ activeDht = null
+
+ if (dht) {
+ try {
+ await dht.destroy()
+ } catch (err) {
+ console.warn(
+ '[relay-conf] dht.destroy failed',
+ err instanceof Error ? err.message : String(err)
+ )
+ }
+ }
+}
diff --git a/packages/core/src/worklet/relay/config.test.ts b/packages/core/src/worklet/relay/config.test.ts
new file mode 100644
index 0000000..e3214af
--- /dev/null
+++ b/packages/core/src/worklet/relay/config.test.ts
@@ -0,0 +1,54 @@
+import b4a from 'b4a'
+import { beforeEach, describe, expect, it } from 'vitest'
+import { configureRelay, isRelayHost, relayConfigSummary, relayThrough } from './config'
+
+const KEY_A = 'a'.repeat(64)
+const HOST_A = '1.2.3.4'
+const KEY_B = 'b'.repeat(64)
+const HOST_B = '5.6.7.8'
+
+beforeEach(() => {
+ configureRelay({ enabled: false, relays: [] })
+})
+
+describe('relay/config', () => {
+ it('relayThrough returns null when disabled, even with relays configured', () => {
+ configureRelay({ relays: [{ keyHex: KEY_A, host: HOST_A }] })
+ expect(relayThrough(false)).toBeNull()
+ })
+
+ it('relayThrough returns null when enabled but no relays', () => {
+ configureRelay({ enabled: true })
+ expect(relayThrough(false)).toBeNull()
+ })
+
+ it('relayThrough returns the keys when enabled with relays', () => {
+ configureRelay({
+ enabled: true,
+ relays: [
+ { keyHex: KEY_A, host: HOST_A },
+ { keyHex: KEY_B, host: HOST_B }
+ ]
+ })
+ const keys = relayThrough(false)
+ expect(keys).toHaveLength(2)
+ expect(keys?.map((k) => b4a.toString(k, 'hex'))).toEqual([KEY_A, KEY_B])
+ })
+
+ it('isRelayHost matches configured hosts only', () => {
+ configureRelay({ enabled: true, relays: [{ keyHex: KEY_A, host: HOST_A }] })
+ expect(isRelayHost(HOST_A)).toBe(true)
+ expect(isRelayHost(HOST_B)).toBe(false)
+ expect(isRelayHost(null)).toBe(false)
+ expect(isRelayHost(undefined)).toBe(false)
+ })
+
+ it('configureRelay replaces relays; summary and isRelayHost follow', () => {
+ configureRelay({ enabled: true, relays: [{ keyHex: KEY_A, host: HOST_A }] })
+ expect(relayConfigSummary()).toEqual({ enabled: true, keyCount: 1 })
+
+ configureRelay({ relays: [] })
+ expect(relayConfigSummary()).toEqual({ enabled: true, keyCount: 0 })
+ expect(isRelayHost(HOST_A)).toBe(false)
+ })
+})
diff --git a/packages/core/src/worklet/relay/config.ts b/packages/core/src/worklet/relay/config.ts
new file mode 100644
index 0000000..6914c0e
--- /dev/null
+++ b/packages/core/src/worklet/relay/config.ts
@@ -0,0 +1,61 @@
+import b4a from 'b4a'
+
+interface RelayEntry {
+ key: Uint8Array
+ host: string
+}
+
+interface RelayState {
+ enabled: boolean
+ relays: RelayEntry[]
+}
+
+const state: RelayState = {
+ enabled: false,
+ relays: []
+}
+
+let relayLoader: (() => void) | null = null
+
+export function registerRelayLoader(load: () => void): void {
+ relayLoader = load
+}
+
+interface RelayEntryInput {
+ keyHex: string
+ host: string
+}
+
+export interface RelayConfigInput {
+ enabled?: boolean
+ relays?: readonly RelayEntryInput[]
+}
+
+function toRelayEntry({ keyHex, host }: RelayEntryInput): RelayEntry {
+ return { key: b4a.from(keyHex, 'hex'), host }
+}
+
+export function configureRelay(input: RelayConfigInput): void {
+ if (typeof input.enabled === 'boolean') {
+ state.enabled = input.enabled
+ }
+
+ if (input.relays) {
+ state.relays = input.relays.map(toRelayEntry)
+ }
+
+ if (state.enabled) relayLoader?.()
+}
+
+export function relayConfigSummary(): { enabled: boolean; keyCount: number } {
+ return { enabled: state.enabled, keyCount: state.relays.length }
+}
+
+export function relayThrough(_force: boolean, _swarm?: unknown): Uint8Array[] | null {
+ if (!state.enabled || state.relays.length === 0) return null
+ return state.relays.map((r) => r.key)
+}
+
+export function isRelayHost(host: string | null | undefined): boolean {
+ return !!host && state.relays.some((r) => r.host === host)
+}
diff --git a/packages/core/src/worklet/rpc/commands.ts b/packages/core/src/worklet/rpc/commands.ts
index a3a18ba..0ea4c33 100644
--- a/packages/core/src/worklet/rpc/commands.ts
+++ b/packages/core/src/worklet/rpc/commands.ts
@@ -13,7 +13,8 @@ export const API = {
forgetPeer: 11,
initDeviceSecret: 12,
hostPairing: 13,
- joinPairing: 14
+ joinPairing: 14,
+ setRelayConfig: 15
},
channels: {
event: 100,
diff --git a/packages/core/src/worklet/rpc/events.ts b/packages/core/src/worklet/rpc/events.ts
index 6120e7d..5b0558c 100644
--- a/packages/core/src/worklet/rpc/events.ts
+++ b/packages/core/src/worklet/rpc/events.ts
@@ -17,6 +17,7 @@ export type TransferStatus =
| 'joined'
| 'disconnected'
| 'reconnecting'
+ | 'connection-type'
export type TransferRole = 'sender' | 'receiver'
@@ -52,6 +53,7 @@ export interface StatusEvent {
totalBytes?: number
bytesTransferred?: number
message?: string
+ connectionType?: 'direct' | 'relay'
}
export interface RoleEvent {
diff --git a/packages/core/src/worklet/rpc/protocol.ts b/packages/core/src/worklet/rpc/protocol.ts
index 906f448..c8b112a 100644
--- a/packages/core/src/worklet/rpc/protocol.ts
+++ b/packages/core/src/worklet/rpc/protocol.ts
@@ -107,6 +107,15 @@ export interface InitDeviceSecretReply {
secretKey: string | null
}
+export interface SetRelayConfigInput {
+ enabled: boolean
+}
+
+export interface SetRelayConfigReply {
+ enabled: boolean
+ keyCount: number
+}
+
export interface RPCErrorPayload {
code: 'BAD_REQUEST' | 'UNKNOWN_COMMAND' | 'INTERNAL_ERROR'
message: string
@@ -156,6 +165,7 @@ export interface TransferRPC {
initDeviceSecret(init: DeviceSecretInit): Promise<InitDeviceSecretReply>
hostPairing(): Promise<HostReply>
joinPairing(topic: string): Promise<JoinReply>
+ setRelayConfig(input: SetRelayConfigInput): Promise<SetRelayConfigReply>
}
export class BadRequestError extends Error {
diff --git a/packages/core/src/worklet/transfer/control-channel.ts b/packages/core/src/worklet/transfer/control-channel.ts
index 115bb82..92441b4 100644
--- a/packages/core/src/worklet/transfer/control-channel.ts
+++ b/packages/core/src/worklet/transfer/control-channel.ts
@@ -29,6 +29,7 @@ export interface TransferReady {
type: 'transfer-ready'
transferId: string
files: TransferOffer[]
+ peer?: string
}
export interface TransferStart {
diff --git a/packages/core/src/worklet/transfer/orchestrator.ts b/packages/core/src/worklet/transfer/orchestrator.ts
index 3a3a7de..9b34592 100644
--- a/packages/core/src/worklet/transfer/orchestrator.ts
+++ b/packages/core/src/worklet/transfer/orchestrator.ts
@@ -24,6 +24,8 @@ import type {
JoinReply,
RememberVoteInput,
RememberVoteReply,
+ SetRelayConfigInput,
+ SetRelayConfigReply,
ShareFileRequest,
ShareFilesReply,
TransferRPC
@@ -66,6 +68,7 @@ import { RememberCoordinator } from '../peers/remember-coordinator'
import { RecognitionCoordinator } from '../peers/recognition-coordinator'
import { DiscoveryCoordinator } from '../peers/discovery'
import { PairingCoordinator } from '../peers/pairing-coordinator'
+import { configureRelay, relayConfigSummary } from '../relay/config'
function createTransferId(): string {
return crypto.randomBytes(16).toString('hex')
@@ -143,6 +146,10 @@ export class TransferOrchestrator implements TransferRPC {
onControlMessage: (message, session) => {
if (this.suspended) return
this.onControlMessage(message, session)
+ },
+ onConnectionType: (peerKey, connectionType) => {
+ if (this.suspended) return
+ this.sendStatus('connection-type', { peer: peerKey, connectionType })
}
},
{ identityStore }
@@ -258,7 +265,9 @@ export class TransferOrchestrator implements TransferRPC {
console.warn(`TransferOrchestrator: dropping inbound ${message.type} in role=${this.role}`)
return
}
- this.emitIPC(message)
+ this.emitIPC(
+ message.type === 'transfer-ready' ? { ...message, peer: session.peerKey } : message
+ )
return
}
@@ -524,6 +533,12 @@ export class TransferOrchestrator implements TransferRPC {
await this.swarm.endSession()
}
+ async setRelayConfig(input: SetRelayConfigInput): Promise<SetRelayConfigReply> {
+ configureRelay({ enabled: input.enabled })
+ const { enabled, keyCount } = relayConfigSummary()
+ return { enabled, keyCount }
+ }
+
async suspend(): Promise<void> {
if (this.suspended) return
diff --git a/packages/core/src/worklet/transfer/swarm.ts b/packages/core/src/worklet/transfer/swarm.ts
index 9c54e99..7f723c8 100644
--- a/packages/core/src/worklet/transfer/swarm.ts
+++ b/packages/core/src/worklet/transfer/swarm.ts
@@ -4,6 +4,9 @@ import Hyperswarm, { type PeerInfo, type PeerSocket } from 'hyperswarm'
import { PeerControlChannel } from './control-channel'
import type { PeerControlMessage } from './control-channel'
import { PeerIdentityStore, type NoiseKeyPair } from './peer-identity-store'
+import { relayThrough, isRelayHost } from '../relay/config'
+
+type ConnectionType = 'direct' | 'relay'
export interface PeerSession {
socket: PeerSocket
@@ -18,6 +21,7 @@ export interface TransferSwarmCallbacks {
onPeerConnected: (session: PeerSession) => void
onPeerDisconnected: (peerKey: string | null, remainingCount: number) => void
onControlMessage: (message: PeerControlMessage, session: PeerSession) => void
+ onConnectionType?: (peerKey: string, connectionType: ConnectionType) => void
}
export interface TransferSwarmOptions {
@@ -59,9 +63,9 @@ export class TransferSwarm {
}
private createSwarm(keyPair?: NoiseKeyPair): Hyperswarm {
- const swarm = keyPair ? new Hyperswarm({ keyPair }) : new Hyperswarm()
+ const swarm = new Hyperswarm({ ...(keyPair ? { keyPair } : {}), relayThrough })
swarm.on('connection', (socket, info) => {
- void this.handleConnection(socket, info).catch((err) => {
+ this.handleConnection(socket, info).catch((err) => {
console.error(
'TransferSwarm: handleConnection failed',
err instanceof Error ? err.message : String(err)
@@ -104,11 +108,37 @@ export class TransferSwarm {
session = { socket, peerKey, controlChannel, handshakeHash: socket.handshakeHash ?? null }
this.peerSessions.set(socket, session)
this.callbacks.onPeerConnected(session)
+ this.classifyConnection(socket, peerKey)
socket.on('close', () => this.cleanupPeer(socket))
socket.on('error', () => this.cleanupPeer(socket))
}
+ private classifyConnection(socket: PeerSocket, peerKey: string): void {
+ if (!this.callbacks.onConnectionType) return
+ const remoteHost = () =>
+ (socket as unknown as { rawStream?: { remoteHost?: string } }).rawStream?.remoteHost
+ const classify = (): ConnectionType => (isRelayHost(remoteHost()) ? 'relay' : 'direct')
+
+ let current = classify()
+ this.callbacks.onConnectionType(peerKey, current)
+
+ if (current !== 'relay') return
+
+ let ticks = 0
+ const timer = setInterval(() => {
+ const next = classify()
+ if (next !== current) {
+ current = next
+ this.callbacks.onConnectionType?.(peerKey, next)
+ }
+ if (next !== 'relay' || ++ticks >= 8) clearInterval(timer)
+ }, 2000)
+ ;(timer as unknown as { unref?: () => void }).unref?.()
+
+ socket.on('close', () => clearInterval(timer))
+ }
+
private cleanupPeer(socket: PeerSocket): void {
const session = this.peerSessions.get(socket)
if (!session) return
diff --git a/packages/domain/src/onboarding.ts b/packages/domain/src/onboarding.ts
index 164c126..8be83b3 100644
--- a/packages/domain/src/onboarding.ts
+++ b/packages/domain/src/onboarding.ts
@@ -2,7 +2,6 @@ export type OnboardingSlideKind = 'pairing' | 'keep-open' | 'privacy'
export const privacyPolicyUrl = 'https://altersend.com/privacy'
export const termsOfServiceUrl = 'https://altersend.com/terms'
-export const abuseEmail = '[email protected]'
export const supportEmail = '[email protected]'
export const websiteUrl = 'https://altersend.com'
export const githubUrl = 'https://github.com/denislupookov/altersend'
diff --git a/packages/domain/src/transfer/binding.ts b/packages/domain/src/transfer/binding.ts
index f3df64e..97cd1d0 100644
--- a/packages/domain/src/transfer/binding.ts
+++ b/packages/domain/src/transfer/binding.ts
@@ -44,7 +44,11 @@ function dispatchRendererEvent(event: RendererTransferEvent): void {
case 'status':
return dispatchStatusEvent(event)
case 'transfer-ready':
- return dispatchToTransferStore({ type: 'transfer_ready', files: event.files })
+ return dispatchToTransferStore({
+ type: 'transfer_ready',
+ files: event.files,
+ peer: event.peer
+ })
case 'role':
return dispatchToTransferStore({ type: 'role_changed', role: event.role })
case 'error':
@@ -125,6 +129,15 @@ function dispatchStatusEvent(event: StatusEvent): void {
case 'peer-disconnected':
if (event.peer) dispatchToTransferStore({ type: 'peer_left', peerKey: event.peer })
return
+ case 'connection-type':
+ if (event.connectionType && event.peer) {
+ dispatchToTransferStore({
+ type: 'connection_type_changed',
+ peer: event.peer,
+ connectionType: event.connectionType
+ })
+ }
+ return
case 'joining':
case 'joined':
case 'disconnected':
diff --git a/packages/domain/src/transfer/reducer.test.ts b/packages/domain/src/transfer/reducer.test.ts
index de33388..1b54525 100644
--- a/packages/domain/src/transfer/reducer.test.ts
+++ b/packages/domain/src/transfer/reducer.test.ts
@@ -405,3 +405,57 @@ describe('transferSessionReducer — misc', () => {
})
})
})
+
+describe('transferSessionReducer — connection type (per-peer)', () => {
+ const SENDER = 'a'.repeat(64)
+ const OTHER = 'b'.repeat(64)
+ const ready = (peer: string): TransferAction => ({
+ type: 'transfer_ready',
+ files: [offer('1', 'a.txt')],
+ peer
+ })
+
+ it('shows the sender connection type, not another peer that connects later', () => {
+ let state = apply(make({ role: 'receiver' }), ready(SENDER))
+ state = apply(state, {
+ type: 'connection_type_changed',
+ peer: SENDER,
+ connectionType: 'direct'
+ })
+ expect(state.connectionType).toBe('direct')
+
+ state = apply(state, { type: 'connection_type_changed', peer: OTHER, connectionType: 'relay' })
+ expect(state.connectionType).toBe('direct')
+ })
+
+ it('derives the sender type regardless of event order', () => {
+ let state = make({ role: 'receiver' })
+ state = apply(state, { type: 'connection_type_changed', peer: SENDER, connectionType: 'relay' })
+ expect(state.connectionType).toBeNull()
+
+ state = apply(state, ready(SENDER))
+ expect(state.connectionType).toBe('relay')
+ })
+
+ it('reflects a relay→direct upgrade on the sender', () => {
+ let state = apply(make({ role: 'receiver' }), ready(SENDER))
+ state = apply(state, { type: 'connection_type_changed', peer: SENDER, connectionType: 'relay' })
+ expect(state.connectionType).toBe('relay')
+
+ state = apply(state, {
+ type: 'connection_type_changed',
+ peer: SENDER,
+ connectionType: 'direct'
+ })
+ expect(state.connectionType).toBe('direct')
+ })
+
+ it('clears per-peer connection state on session end', () => {
+ let state = apply(make({ role: 'receiver' }), ready(SENDER))
+ state = apply(state, { type: 'connection_type_changed', peer: SENDER, connectionType: 'relay' })
+ state = apply(state, { type: 'status_changed', state: 'disconnected' })
+ expect(state.connectionType).toBeNull()
+ expect(state.transferPeerKey).toBeNull()
+ expect(state.connectionTypes).toEqual({})
+ })
+})
diff --git a/packages/domain/src/transfer/reducer.ts b/packages/domain/src/transfer/reducer.ts
index 8ad968d..de20723 100644
--- a/packages/domain/src/transfer/reducer.ts
+++ b/packages/domain/src/transfer/reducer.ts
@@ -11,6 +11,7 @@ import type {
ConnectionState,
IncomingPairRequest,
TransferAction,
+ TransferConnectionType,
TransferSessionState
} from './types'
@@ -26,6 +27,9 @@ export { TRANSFER_ERROR_CODES } from './types'
export const initialTransferSessionState: TransferSessionState = {
topic: '',
connectionState: 'disconnected',
+ connectionType: null,
+ connectionTypes: {},
+ transferPeerKey: null,
role: null,
peerCount: 0,
isReconnecting: false,
@@ -49,6 +53,13 @@ export const initialTransferSessionState: TransferSessionState = {
peers: []
}
+function deriveConnectionType(
+ connectionTypes: Record<string, TransferConnectionType>,
+ transferPeerKey: string | null
+): TransferConnectionType | null {
+ return transferPeerKey ? (connectionTypes[transferPeerKey] ?? null) : null
+}
+
function clearError(state: TransferSessionState): TransferSessionState {
return state.errorCode === null && state.errorMessage === null
? state
@@ -77,6 +88,9 @@ function endSession(state: TransferSessionState): TransferSessionState {
peerDownloads: {},
connectedPeers: {},
connectionState: 'disconnected',
+ connectionType: null,
+ connectionTypes: {},
+ transferPeerKey: null,
peerCount: 0,
topic: '',
errorCode: null,
@@ -137,6 +151,15 @@ export function transferSessionReducer(
}
}
}
+ case 'connection_type_changed': {
+ if (state.connectionTypes[action.peer] === action.connectionType) return state
+ const connectionTypes = { ...state.connectionTypes, [action.peer]: action.connectionType }
+ return {
+ ...state,
+ connectionTypes,
+ connectionType: deriveConnectionType(connectionTypes, state.transferPeerKey)
+ }
+ }
case 'reconnecting':
return { ...state, isReconnecting: true }
case 'clear_session':
@@ -254,6 +277,9 @@ export function transferSessionReducer(
peerDownloads: {},
connectedPeers: {},
connectionState: 'joining',
+ connectionType: null,
+ connectionTypes: {},
+ transferPeerKey: null,
peerCount: 0,
errorCode: null,
errorMessage: null
@@ -261,6 +287,7 @@ export function transferSessionReducer(
case 'transfer_ready': {
if (state.role !== 'receiver') return state
const incomingFileOffers = mergeIncomingFileOffers(state.incomingFileOffers, action.files)
+ const transferPeerKey = action.peer ?? state.transferPeerKey
return {
...state,
incomingFileOffers,
@@ -268,6 +295,8 @@ export function transferSessionReducer(
state.receiveDownloadStates,
incomingFileOffers
),
+ transferPeerKey,
+ connectionType: deriveConnectionType(state.connectionTypes, transferPeerKey),
transferId: action.files[0]?.transferId ?? state.transferId,
errorCode: null,
errorMessage: null
diff --git a/packages/domain/src/transfer/types.ts b/packages/domain/src/transfer/types.ts
index e96887a..bbfc074 100644
--- a/packages/domain/src/transfer/types.ts
+++ b/packages/domain/src/transfer/types.ts
@@ -22,6 +22,8 @@ export type { TransferErrorCode }
export type ConnectionState = 'disconnected' | 'joining' | 'joined' | 'peer-connected'
+export type TransferConnectionType = 'direct' | 'relay'
+
export type PeerPairStatus = 'requested' | 'paired'
export interface IncomingPairRequest {
@@ -59,6 +61,9 @@ export interface RememberState {
export interface TransferSessionState {
topic: string
connectionState: ConnectionState
+ connectionType: TransferConnectionType | null
+ connectionTypes: Record<string, TransferConnectionType>
+ transferPeerKey: string | null
role: TransferRole | null
peerCount: number
isReconnecting: boolean
@@ -86,6 +91,7 @@ export type TransferAction =
| { type: 'clear_session' }
| { type: 'set_error'; code?: TransferErrorCode; message: string }
| { type: 'status_changed'; state: ConnectionState; peers?: number }
+ | { type: 'connection_type_changed'; peer: string; connectionType: TransferConnectionType }
| { type: 'role_changed'; role: TransferRole | null }
| { type: 'apply_sharing_progress'; event: SharingStatusEvent }
| { type: 'init_upload_items'; items: SenderUploadItem[] }
@@ -106,7 +112,7 @@ export type TransferAction =
intendedDestination: SaveDestination
savedTo?: string
}
- | { type: 'transfer_ready'; files: IncomingFileOffer[] }
+ | { type: 'transfer_ready'; files: IncomingFileOffer[]; peer?: string }
| { type: 'reconnecting' }
| { type: 'peer_unreachable' }
| { type: 'remember_confirmed'; peerKey: string; displayName: string }
diff --git a/packages/locales/src/locales/de-DE/common.json b/packages/locales/src/locales/de-DE/common.json
index 830387e..c9037d7 100644
--- a/packages/locales/src/locales/de-DE/common.json
+++ b/packages/locales/src/locales/de-DE/common.json
@@ -30,7 +30,8 @@
"copyText": "Text kopieren",
"add": "Hinzufügen",
"showMore": "Mehr anzeigen",
- "showLess": "Weniger anzeigen"
+ "showLess": "Weniger anzeigen",
+ "learnMore": "Mehr erfahren"
},
"labels": {
"settings": "Einstellungen",
@@ -76,7 +77,8 @@
},
"status": {
"connected": "Verbunden",
- "wantsToSend": "möchte dir {{label}}{{size}} senden"
+ "wantsToSend": "möchte dir {{label}}{{size}} senden",
+ "connectedViaRelay": "Verbunden über Relay"
},
"confirm": {
"leaveShareSession": "Durch das Verlassen wird Ihre aktive Freigabesitzung beendet. Weitermachen?",
diff --git a/packages/locales/src/locales/de-DE/settings.json b/packages/locales/src/locales/de-DE/settings.json
index 7d4a1ee..966b17f 100644
--- a/packages/locales/src/locales/de-DE/settings.json
+++ b/packages/locales/src/locales/de-DE/settings.json
@@ -11,6 +11,12 @@
"label": "Absturzberichte",
"description": "Teilen Sie anonyme Absturzdaten, um AlterSend zu verbessern"
},
+ "relay": {
+ "label": "Relay verwenden, wenn keine direkte Verbindung möglich ist",
+ "description": "Wenn sich zwei Geräte nicht direkt verbinden können (zum Beispiel beide über ein VPN), wird die Übertragung über das Relay von AlterSend geleitet. Dateien bleiben Ende-zu-Ende-verschlüsselt.",
+ "contact": "Benötigen Sie ein dediziertes Relay oder höhere Limits?",
+ "fairUse": "Das Relay hat Grenzen für die Übertragungsgröße und dafür, wie viele Übertragungen gleichzeitig laufen können."
+ },
"rows": {
"security": "Sicherheit",
"feedback": "Rückmeldung",
@@ -24,7 +30,8 @@
"termsHint": "Regeln für die Verwendung von AlterSend",
"website": "Webseite",
"noDevices": "Noch keine Geräte",
- "pairedCount": "{{count}} gekoppelt"
+ "pairedCount": "{{count}} gekoppelt",
+ "connection": "Relay"
},
"legal": {
"terms": "Nutzungsbedingungen",
diff --git a/packages/locales/src/locales/en-GB/common.json b/packages/locales/src/locales/en-GB/common.json
index d0fd515..fb3cbdd 100644
--- a/packages/locales/src/locales/en-GB/common.json
+++ b/packages/locales/src/locales/en-GB/common.json
@@ -30,7 +30,8 @@
"copyText": "Copy Text",
"add": "Add",
"showMore": "Show more",
- "showLess": "Show less"
+ "showLess": "Show less",
+ "learnMore": "Learn more"
},
"labels": {
"settings": "Settings",
@@ -76,7 +77,8 @@
},
"status": {
"connected": "Connected",
- "wantsToSend": "wants to send you {{label}}{{size}}"
+ "wantsToSend": "wants to send you {{label}}{{size}}",
+ "connectedViaRelay": "Connected via relay"
},
"confirm": {
"leaveShareSession": "Leaving will end your active share session. Continue?",
diff --git a/packages/locales/src/locales/en-GB/settings.json b/packages/locales/src/locales/en-GB/settings.json
index c1c7661..a0803fc 100644
--- a/packages/locales/src/locales/en-GB/settings.json
+++ b/packages/locales/src/locales/en-GB/settings.json
@@ -11,6 +11,12 @@
"label": "Crash reports",
"description": "Share anonymous crash data to help improve AlterSend"
},
+ "relay": {
+ "label": "Use relay when direct connection fails",
+ "description": "When two devices can't connect directly (for example both on a VPN), the transfer is routed through AlterSend's relay. Files stay end-to-end encrypted.",
+ "contact": "Need a dedicated relay or higher limits?",
+ "fairUse": "The relay has limits on transfer size and how many transfers can run at once."
+ },
"rows": {
"security": "Security",
"feedback": "Feedback",
@@ -24,7 +30,8 @@
"termsHint": "Rules for using AlterSend",
"website": "Website",
"noDevices": "No devices yet",
- "pairedCount": "{{count}} paired"
+ "pairedCount": "{{count}} paired",
+ "connection": "Relay"
},
"legal": {
"terms": "Terms of Use",
diff --git a/packages/locales/src/locales/en-US/common.json b/packages/locales/src/locales/en-US/common.json
index d0fd515..fb3cbdd 100644
--- a/packages/locales/src/locales/en-US/common.json
+++ b/packages/locales/src/locales/en-US/common.json
@@ -30,7 +30,8 @@
"copyText": "Copy Text",
"add": "Add",
"showMore": "Show more",
- "showLess": "Show less"
+ "showLess": "Show less",
+ "learnMore": "Learn more"
},
"labels": {
"settings": "Settings",
@@ -76,7 +77,8 @@
},
"status": {
"connected": "Connected",
- "wantsToSend": "wants to send you {{label}}{{size}}"
+ "wantsToSend": "wants to send you {{label}}{{size}}",
+ "connectedViaRelay": "Connected via relay"
},
"confirm": {
"leaveShareSession": "Leaving will end your active share session. Continue?",
diff --git a/packages/locales/src/locales/en-US/settings.json b/packages/locales/src/locales/en-US/settings.json
index c1c7661..a0803fc 100644
--- a/packages/locales/src/locales/en-US/settings.json
+++ b/packages/locales/src/locales/en-US/settings.json
@@ -11,6 +11,12 @@
"label": "Crash reports",
"description": "Share anonymous crash data to help improve AlterSend"
},
+ "relay": {
+ "label": "Use relay when direct connection fails",
+ "description": "When two devices can't connect directly (for example both on a VPN), the transfer is routed through AlterSend's relay. Files stay end-to-end encrypted.",
+ "contact": "Need a dedicated relay or higher limits?",
+ "fairUse": "The relay has limits on transfer size and how many transfers can run at once."
+ },
"rows": {
"security": "Security",
"feedback": "Feedback",
@@ -24,7 +30,8 @@
"termsHint": "Rules for using AlterSend",
"website": "Website",
"noDevices": "No devices yet",
- "pairedCount": "{{count}} paired"
+ "pairedCount": "{{count}} paired",
+ "connection": "Relay"
},
"legal": {
"terms": "Terms of Use",
diff --git a/packages/locales/src/locales/es-419/common.json b/packages/locales/src/locales/es-419/common.json
index 892e198..7f769ad 100644
--- a/packages/locales/src/locales/es-419/common.json
+++ b/packages/locales/src/locales/es-419/common.json
@@ -30,7 +30,8 @@
"copyText": "Copiar texto",
"add": "Agregar",
"showMore": "Mostrar más",
- "showLess": "Mostrar menos"
+ "showLess": "Mostrar menos",
+ "learnMore": "Más información"
},
"labels": {
"settings": "Configuración",
@@ -76,7 +77,8 @@
},
"status": {
"connected": "Conectado",
- "wantsToSend": "quiere enviarte {{label}}{{size}}"
+ "wantsToSend": "quiere enviarte {{label}}{{size}}",
+ "connectedViaRelay": "Conectado vía relé"
},
"confirm": {
"leaveShareSession": "Al salir, finalizará su sesión activa para compartir. ¿Continuar?",
diff --git a/packages/locales/src/locales/es-419/settings.json b/packages/locales/src/locales/es-419/settings.json
index acd9e9d..3eb7582 100644
--- a/packages/locales/src/locales/es-419/settings.json
+++ b/packages/locales/src/locales/es-419/settings.json
@@ -11,6 +11,12 @@
"label": "Informes de fallos",
"description": "Comparte datos anónimos sobre fallos para ayudar a mejorar AlterSend"
},
+ "relay": {
+ "label": "Usar relé cuando falle la conexión directa",
+ "description": "Cuando dos dispositivos no pueden conectarse directamente (por ejemplo, ambos con VPN), la transferencia se enruta a través del relé de AlterSend. Los archivos siguen cifrados de extremo a extremo.",
+ "contact": "¿Necesitas un relé dedicado o límites más altos?",
+ "fairUse": "El relé tiene límites en el tamaño de las transferencias y en cuántas pueden ejecutarse a la vez."
+ },
"rows": {
"security": "Seguridad",
"feedback": "Comentarios",
@@ -24,7 +30,8 @@
"termsHint": "Reglas para usar AlterSend",
"website": "Sitio web",
"noDevices": "Aún no hay dispositivos",
- "pairedCount": "{{count}} emparejados"
+ "pairedCount": "{{count}} emparejados",
+ "connection": "Relé"
},
"legal": {
"terms": "Términos de uso",
diff --git a/packages/locales/src/locales/es-ES/common.json b/packages/locales/src/locales/es-ES/common.json
index b24618a..f492a09 100644
--- a/packages/locales/src/locales/es-ES/common.json
+++ b/packages/locales/src/locales/es-ES/common.json
@@ -30,7 +30,8 @@
"copyText": "Copiar texto",
"add": "Añadir",
"showMore": "Mostrar más",
- "showLess": "Mostrar menos"
+ "showLess": "Mostrar menos",
+ "learnMore": "Más información"
},
"labels": {
"settings": "Ajustes",
@@ -76,7 +77,8 @@
},
"status": {
"connected": "Conectado",
- "wantsToSend": "quiere enviarte {{label}}{{size}}"
+ "wantsToSend": "quiere enviarte {{label}}{{size}}",
+ "connectedViaRelay": "Conectado vía relé"
},
"confirm": {
"leaveShareSession": "Al salir, finalizará su sesión activa para compartir. ¿Continuar?",
diff --git a/packages/locales/src/locales/es-ES/settings.json b/packages/locales/src/locales/es-ES/settings.json
index 46a3695..9133af3 100644
--- a/packages/locales/src/locales/es-ES/settings.json
+++ b/packages/locales/src/locales/es-ES/settings.json
@@ -11,6 +11,12 @@
"label": "Informes de fallos",
"description": "Comparte datos anónimos sobre fallos para ayudar a mejorar AlterSend"
},
+ "relay": {
+ "label": "Usar relé cuando falle la conexión directa",
+ "description": "Cuando dos dispositivos no pueden conectarse directamente (por ejemplo, ambos con VPN), la transferencia se enruta a través del relé de AlterSend. Los archivos siguen cifrados de extremo a extremo.",
+ "contact": "¿Necesitas un relé dedicado o límites más altos?",
+ "fairUse": "El relé tiene límites en el tamaño de las transferencias y en cuántas pueden ejecutarse a la vez."
+ },
"rows": {
"security": "Seguridad",
"feedback": "Comentarios",
@@ -24,7 +30,8 @@
"termsHint": "Reglas para usar AlterSend",
"website": "Sitio web",
"noDevices": "Aún no hay dispositivos",
- "pairedCount": "{{count}} emparejados"
+ "pairedCount": "{{count}} emparejados",
+ "connection": "Relé"
},
"legal": {
"terms": "Términos de uso",
diff --git a/packages/locales/src/locales/fr-FR/common.json b/packages/locales/src/locales/fr-FR/common.json
index cf8ae3c..4cf29ec 100644
--- a/packages/locales/src/locales/fr-FR/common.json
+++ b/packages/locales/src/locales/fr-FR/common.json
@@ -30,7 +30,8 @@
"copyText": "Copier le texte",
"add": "Ajouter",
"showMore": "Afficher plus",
- "showLess": "Afficher moins"
+ "showLess": "Afficher moins",
+ "learnMore": "En savoir plus"
},
"labels": {
"settings": "Paramètres",
@@ -76,7 +77,8 @@
},
"status": {
"connected": "Connecté",
- "wantsToSend": "veut vous envoyer {{label}}{{size}}"
+ "wantsToSend": "veut vous envoyer {{label}}{{size}}",
+ "connectedViaRelay": "Connecté via relais"
},
"confirm": {
"leaveShareSession": "Quitter mettra fin à votre session de partage active. Continuer?",
diff --git a/packages/locales/src/locales/fr-FR/settings.json b/packages/locales/src/locales/fr-FR/settings.json
index 4fda75e..ed14c57 100644
--- a/packages/locales/src/locales/fr-FR/settings.json
+++ b/packages/locales/src/locales/fr-FR/settings.json
@@ -11,6 +11,12 @@
"label": "Rapports d'erreur",
"description": "Partagez des données anonymes sur les accidents pour contribuer à améliorer AlterSend"
},
+ "relay": {
+ "label": "Utiliser un relais en cas d’échec de la connexion directe",
+ "description": "Quand deux appareils ne peuvent pas se connecter directement (par exemple tous deux sur un VPN), le transfert passe par le relais d'AlterSend. Les fichiers restent chiffrés de bout en bout.",
+ "contact": "Besoin d’un relais dédié ou de limites plus élevées ?",
+ "fairUse": "Le relais impose des limites sur la taille des transferts et sur le nombre de transferts simultanés."
+ },
"rows": {
"security": "Sécurité",
"feedback": "Commentaires",
@@ -24,7 +30,8 @@
"termsHint": "Règles d'utilisation de AlterSend",
"website": "Site Web",
"noDevices": "Aucun appareil pour l’instant",
- "pairedCount": "{{count}} associé(s)"
+ "pairedCount": "{{count}} associé(s)",
+ "connection": "Relais"
},
"legal": {
"terms": "Conditions d'utilisation",
diff --git a/packages/locales/src/locales/it-IT/common.json b/packages/locales/src/locales/it-IT/common.json
index 16c35b2..46a19a0 100644
--- a/packages/locales/src/locales/it-IT/common.json
+++ b/packages/locales/src/locales/it-IT/common.json
@@ -30,7 +30,8 @@
"copyText": "Copia testo",
"add": "Aggiungi",
"showMore": "Mostra altro",
- "showLess": "Mostra meno"
+ "showLess": "Mostra meno",
+ "learnMore": "Scopri di più"
},
"labels": {
"settings": "Impostazioni",
@@ -76,7 +77,8 @@
},
"status": {
"connected": "Connesso",
- "wantsToSend": "vuole inviarti {{label}}{{size}}"
+ "wantsToSend": "vuole inviarti {{label}}{{size}}",
+ "connectedViaRelay": "Connesso via relay"
},
"confirm": {
"leaveShareSession": "L'abbandono terminerà la sessione di condivisione attiva. Continuare?",
diff --git a/packages/locales/src/locales/it-IT/settings.json b/packages/locales/src/locales/it-IT/settings.json
index dfee0a0..100f38b 100644
--- a/packages/locales/src/locales/it-IT/settings.json
+++ b/packages/locales/src/locales/it-IT/settings.json
@@ -11,6 +11,12 @@
"label": "Rapporti sugli incidenti",
"description": "Condividi dati anonimi sugli arresti anomali per contribuire a migliorare AlterSend"
},
+ "relay": {
+ "label": "Usa il relay quando la connessione diretta non riesce",
+ "description": "Quando due dispositivi non riescono a connettersi direttamente (ad esempio entrambi su una VPN), il trasferimento passa attraverso il relay di AlterSend. I file restano cifrati end-to-end.",
+ "contact": "Ti serve un relay dedicato o limiti più alti?",
+ "fairUse": "Il relay ha limiti sulla dimensione dei trasferimenti e su quanti possono essere eseguiti contemporaneamente."
+ },
"rows": {
"security": "Sicurezza",
"feedback": "Segnalazioni",
@@ -24,7 +30,8 @@
"termsHint": "Regole per l'utilizzo di AlterSend",
"website": "Sito web",
"noDevices": "Ancora nessun dispositivo",
- "pairedCount": "{{count}} accoppiati"
+ "pairedCount": "{{count}} accoppiati",
+ "connection": "Relay"
},
"legal": {
"terms": "Condizioni d'uso",
diff --git a/packages/locales/src/locales/ja-JP/common.json b/packages/locales/src/locales/ja-JP/common.json
index 04f03d0..f2ca307 100644
--- a/packages/locales/src/locales/ja-JP/common.json
+++ b/packages/locales/src/locales/ja-JP/common.json
@@ -30,7 +30,8 @@
"copyText": "テキストをコピー",
"add": "追加",
"showMore": "もっと見る",
- "showLess": "折りたたむ"
+ "showLess": "折りたたむ",
+ "learnMore": "詳細を見る"
},
"labels": {
"settings": "設定",
@@ -76,7 +77,8 @@
},
"status": {
"connected": "接続済み",
- "wantsToSend": "が{{label}}{{size}}を送信しようとしています"
+ "wantsToSend": "が{{label}}{{size}}を送信しようとしています",
+ "connectedViaRelay": "リレー経由で接続"
},
"confirm": {
"leaveShareSession": "退出すると、アクティブな共有セッションが終了します。続く?",
diff --git a/packages/locales/src/locales/ja-JP/settings.json b/packages/locales/src/locales/ja-JP/settings.json
index a58c479..6fe1997 100644
--- a/packages/locales/src/locales/ja-JP/settings.json
+++ b/packages/locales/src/locales/ja-JP/settings.json
@@ -11,6 +11,12 @@
"label": "クラッシュレポート",
"description": "AlterSend 改善のため匿名のクラッシュデータを共有する"
},
+ "relay": {
+ "label": "直接接続できないときにリレーを使用",
+ "description": "2台のデバイスが直接接続できない場合(例:両方がVPN上)、転送はAlterSendのリレーを経由します。ファイルはエンドツーエンドで暗号化されたままです。",
+ "contact": "専用リレーや上限の引き上げが必要ですか?",
+ "fairUse": "リレーには、転送サイズと同時に実行できる転送数に制限があります。"
+ },
"rows": {
"security": "セキュリティ",
"feedback": "フィードバック",
@@ -24,7 +30,8 @@
"termsHint": "AlterSend の利用ルール",
"website": "Webサイト",
"noDevices": "デバイスはまだありません",
- "pairedCount": "{{count}} 台ペアリング済み"
+ "pairedCount": "{{count}} 台ペアリング済み",
+ "connection": "リレー"
},
"legal": {
"terms": "利用規約",
diff --git a/packages/locales/src/locales/ko-KR/common.json b/packages/locales/src/locales/ko-KR/common.json
index a300014..1fb7862 100644
--- a/packages/locales/src/locales/ko-KR/common.json
+++ b/packages/locales/src/locales/ko-KR/common.json
@@ -30,7 +30,8 @@
"copyText": "텍스트 복사",
"add": "추가",
"showMore": "더 보기",
- "showLess": "접기"
+ "showLess": "접기",
+ "learnMore": "자세히 보기"
},
"labels": {
"settings": "설정",
@@ -76,7 +77,8 @@
},
"status": {
"connected": "연결됨",
- "wantsToSend": "님이 {{label}}{{size}}을 보내려고 합니다"
+ "wantsToSend": "님이 {{label}}{{size}}을 보내려고 합니다",
+ "connectedViaRelay": "릴레이를 통해 연결됨"
},
"confirm": {
"leaveShareSession": "나가면 활성 공유 세션이 종료됩니다. 계속하다?",
diff --git a/packages/locales/src/locales/ko-KR/settings.json b/packages/locales/src/locales/ko-KR/settings.json
index 840fe00..f2f635b 100644
--- a/packages/locales/src/locales/ko-KR/settings.json
+++ b/packages/locales/src/locales/ko-KR/settings.json
@@ -11,6 +11,12 @@
"label": "충돌 보고서",
"description": "AlterSend 개선을 위해 익명 충돌 데이터 공유"
},
+ "relay": {
+ "label": "직접 연결이 실패하면 릴레이 사용",
+ "description": "두 기기가 직접 연결할 수 없을 때(예: 둘 다 VPN 사용) 전송이 AlterSend 릴레이를 통해 이루어집니다. 파일은 종단 간 암호화가 유지됩니다.",
+ "contact": "전용 릴레이나 더 높은 한도가 필요하신가요?",
+ "fairUse": "릴레이에는 전송 크기와 동시에 실행할 수 있는 전송 수에 제한이 있습니다."
+ },
"rows": {
"security": "보안",
"feedback": "피드백",
@@ -24,7 +30,8 @@
"termsHint": "AlterSend 사용 규칙",
"website": "웹사이트",
"noDevices": "아직 기기가 없습니다",
- "pairedCount": "{{count}}개 페어링됨"
+ "pairedCount": "{{count}}개 페어링됨",
+ "connection": "릴레이"
},
"legal": {
"terms": "이용약관",
diff --git a/packages/locales/src/locales/pt-BR/common.json b/packages/locales/src/locales/pt-BR/common.json
index 825a13d..ff49b78 100644
--- a/packages/locales/src/locales/pt-BR/common.json
+++ b/packages/locales/src/locales/pt-BR/common.json
@@ -30,7 +30,8 @@
"copyText": "Copiar texto",
"add": "Adicionar",
"showMore": "Mostrar mais",
- "showLess": "Mostrar menos"
+ "showLess": "Mostrar menos",
+ "learnMore": "Saiba mais"
},
"labels": {
"settings": "Configurações",
@@ -76,7 +77,8 @@
},
"status": {
"connected": "Conectado",
- "wantsToSend": "quer enviar {{label}}{{size}} para você"
+ "wantsToSend": "quer enviar {{label}}{{size}} para você",
+ "connectedViaRelay": "Conectado via retransmissor"
},
"confirm": {
"leaveShareSession": "Sair encerrará sua sessão de compartilhamento ativa. Continuar?",
diff --git a/packages/locales/src/locales/pt-BR/settings.json b/packages/locales/src/locales/pt-BR/settings.json
index d0b1df5..c36ae12 100644
--- a/packages/locales/src/locales/pt-BR/settings.json
+++ b/packages/locales/src/locales/pt-BR/settings.json
@@ -11,6 +11,12 @@
"label": "Relatórios de falhas",
"description": "Compartilhe dados anônimos de falhas para ajudar a melhorar o AlterSend"
},
+ "relay": {
+ "label": "Usar retransmissor quando a conexão direta falhar",
+ "description": "Quando dois dispositivos não conseguem se conectar diretamente (por exemplo, ambos em uma VPN), a transferência é roteada pelo retransmissor da AlterSend. Os arquivos permanecem criptografados de ponta a ponta.",
+ "contact": "Precisa de um retransmissor dedicado ou limites maiores?",
+ "fairUse": "O retransmissor tem limites de tamanho de transferência e de quantas podem ocorrer ao mesmo tempo."
+ },
"rows": {
"security": "Segurança",
"feedback": "Feedback",
@@ -24,7 +30,8 @@
"termsHint": "Regras para usar o AlterSend",
"website": "Site",
"noDevices": "Ainda não há dispositivos",
- "pairedCount": "{{count}} emparelhados"
+ "pairedCount": "{{count}} emparelhados",
+ "connection": "Retransmissor"
},
"legal": {
"terms": "Termos de Uso",
diff --git a/packages/locales/src/locales/zh-CN/common.json b/packages/locales/src/locales/zh-CN/common.json
index d88b900..39dca06 100644
--- a/packages/locales/src/locales/zh-CN/common.json
+++ b/packages/locales/src/locales/zh-CN/common.json
@@ -30,7 +30,8 @@
"copyText": "复制文本",
"add": "添加",
"showMore": "显示更多",
- "showLess": "收起"
+ "showLess": "收起",
+ "learnMore": "了解更多"
},
"labels": {
"settings": "设置",
@@ -76,7 +77,8 @@
},
"status": {
"connected": "已连接",
- "wantsToSend": "想要发送 {{label}}{{size}} 给你"
+ "wantsToSend": "想要发送 {{label}}{{size}} 给你",
+ "connectedViaRelay": "已通过中继连接"
},
"confirm": {
"leaveShareSession": "离开将结束您的活跃共享会话。继续?",
diff --git a/packages/locales/src/locales/zh-CN/settings.json b/packages/locales/src/locales/zh-CN/settings.json
index 83bc5f0..b4bffe4 100644
--- a/packages/locales/src/locales/zh-CN/settings.json
+++ b/packages/locales/src/locales/zh-CN/settings.json
@@ -11,6 +11,12 @@
"label": "崩溃报告",
"description": "共享匿名崩溃数据以帮助改进AlterSend"
},
+ "relay": {
+ "label": "直连失败时使用中继",
+ "description": "当两台设备无法直接连接时(例如都在使用 VPN),传输会通过 AlterSend 的中继进行。文件仍保持端到端加密。",
+ "contact": "需要专用中继或更高的限额?",
+ "fairUse": "中继对传输大小和同时进行的传输数量有限制。"
+ },
"rows": {
"security": "安全",
"feedback": "反馈",
@@ -24,7 +30,8 @@
"termsHint": "AlterSend 使用规则",
"website": "网站",
"noDevices": "暂无设备",
- "pairedCount": "已配对 {{count}} 台"
+ "pairedCount": "已配对 {{count}} 台",
+ "connection": "中继"
},
"legal": {
"terms": "使用条款",
diff --git a/packages/locales/src/locales/zh-TW/common.json b/packages/locales/src/locales/zh-TW/common.json
index 8f282d7..759c31f 100644
--- a/packages/locales/src/locales/zh-TW/common.json
+++ b/packages/locales/src/locales/zh-TW/common.json
@@ -30,7 +30,8 @@
"copyText": "複製文字",
"add": "新增",
"showMore": "顯示更多",
- "showLess": "收起"
+ "showLess": "收起",
+ "learnMore": "瞭解更多"
},
"labels": {
"settings": "設定",
@@ -76,7 +77,8 @@
},
"status": {
"connected": "已連線",
- "wantsToSend": "想要傳送 {{label}}{{size}} 給你"
+ "wantsToSend": "想要傳送 {{label}}{{size}} 給你",
+ "connectedViaRelay": "已透過中繼連線"
},
"confirm": {
"leaveShareSession": "離開將結束您的活躍共享會話。繼續?",
diff --git a/packages/locales/src/locales/zh-TW/settings.json b/packages/locales/src/locales/zh-TW/settings.json
index e60338d..5b0abaf 100644
--- a/packages/locales/src/locales/zh-TW/settings.json
+++ b/packages/locales/src/locales/zh-TW/settings.json
@@ -11,6 +11,12 @@
"label": "崩潰報告",
"description": "共享匿名崩潰資料以幫助改進AlterSend"
},
+ "relay": {
+ "label": "直連失敗時使用中繼",
+ "description": "當兩台裝置無法直接連線時(例如都在使用 VPN),傳輸會透過 AlterSend 的中繼進行。檔案仍維持端對端加密。",
+ "contact": "需要專用中繼或更高的額度?",
+ "fairUse": "中繼對傳輸大小和同時進行的傳輸數量有限制。"
+ },
"rows": {
"security": "安全",
"feedback": "意見回饋",
@@ -24,7 +30,8 @@
"termsHint": "AlterSend 使用規則",
"website": "網站",
"noDevices": "尚無裝置",
- "pairedCount": "已配對 {{count}} 台"
+ "pairedCount": "已配對 {{count}} 台",
+ "connection": "中繼"
},
"legal": {
"terms": "使用條款",
diff --git a/packages/locales/src/resources.test.ts b/packages/locales/src/resources.test.ts
index 69e50d0..eb049c1 100644
--- a/packages/locales/src/resources.test.ts
+++ b/packages/locales/src/resources.test.ts
@@ -41,7 +41,8 @@ const identicalValueAllowList = new Set([
'GitHub',
'GitHub Issues',
'QR',
- 'OK'
+ 'OK',
+ 'Relay'
])
const identicalKeyAllowList = new Set([