내장 지갑
로그인한 사용자마다 EVM 지갑을 만들어 줍니다. 사용자는 지갑 앱이나 시드 문구 없이 쓰고, 서비스는 SDK로 주소를 읽고 서명을 요청합니다.
설정
- 콘솔 > 고급 > 내장 지갑에서 "가입하면 지갑 자동으로 만들기"를 켜고 체인을 고릅니다.
- 프로젝트 설정의 허용 도메인에 서비스 주소를 넣습니다. 지갑은 허용된 도메인에서만 동작합니다.
- SDK에서 wallet.autoCreate를 켭니다.
app.ts
import { Authon } from '@authon/js';
const authon = new Authon('pk_live_...', {
wallet: { autoCreate: true },
});
// After sign-in the wallet already exists.
const wallet = await authon.wallet.ensure();
// { address, protected, needsRestore, devices }
const signature = await authon.wallet.signTypedData(order);사용자가 겪는 순간
| 언제 | 화면 | 일어나는 일 |
|---|---|---|
| 가입하거나 로그인할 때 | 화면 없음 | 지갑이 함께 만들어집니다. 주소나 시드 문구는 사용자에게 보이지 않습니다. |
| 첫 입금 전 | 확인 카드 1장 + Face ID·지문 | 패스키로 지갑을 보호합니다. 보호하지 않은 지갑은 기기를 잃으면 되찾을 수 없으니, 보호 전에는 입금을 막아 두세요. |
| 새 기기나 다른 서비스에서 처음 쓸 때 | 기기마다 1회 | 같은 패스키로 본인을 확인하면 같은 지갑을 그대로 씁니다. 패스키는 iCloud 키체인·Google 비밀번호 관리자로 동기화됩니다. |
wallet.ts
// Call from a button click: the browser only shows the passkey prompt after a user gesture.
await authon.wallet.protect();
// On a new device or another site (wallet.needsRestore === true):
await authon.wallet.restore();키 보관
지갑 키는 세 조각으로 나뉘고, 서명에는 그중 두 조각이 필요합니다. Authon은 서버 조각 하나만 갖고 있어서 Authon이나 서비스 운영자가 사용자 지갑을 혼자 움직일 수 없습니다.
| 사용자 기기 | 브라우저 저장소에 추출 불가능한 키로 암호화 |
| Authon 서버 | 서버 전용 키로 봉인 |
| 패스키 백업 | 사용자 패스키(PRF)로만 열림 |
앱 (iOS · Android · React Native)
앱도 웹과 같은 지갑을 씁니다. 같은 사용자면 웹과 앱의 주소가 같고, 앱은 기기 목록에 기기 하나로 추가됩니다. 기기에는 기기 조각만 저장하고(iOS 키체인·Secure Enclave, Android Keystore), 서명할 때마다 서버 조각을 받아 잠깐 합친 뒤 지웁니다.
- 콘솔 내장 지갑 → 앱 등록에 iOS Team ID와 Bundle ID, Android 패키지 이름과 출시 서명 인증서 SHA-256을 넣습니다.
- iOS는 Associated Domains에 webcredentials:wallet.authon.dev를 넣습니다. Android는 Credential Manager 의존성만 있으면 됩니다.
- Authon이 서명 정보를 확인해 승인하면 그 앱에서 패스키 백업과 복구가 동작합니다. 승인 전에도 지갑 생성과 서명은 됩니다.
Wallet.swift
import Authon
import AuthonWalletAuthon
let authon = Authon(publishableKey: "pk_live_...")
let wallet = AuthonWallet(authon: authon)
let w = try await wallet.create() // same address as on the web for this user
let signature = try await wallet.signTypedData(order)
try await wallet.protect() // passkey backup (iOS 18+)
try await wallet.restore() // new phone or reinstallWallet.kt
val wallet = AuthonWallet(authon, activityProvider = { currentActivity })
val w = wallet.create()
val signature = wallet.signTypedData(orderJson)
wallet.protect() // passkey backup (Credential Manager PRF)
wallet.restore(RestoreMode.ADD) // new phone or reinstall웹에서 만든 백업 패스키(iCloud 키체인·Google 비밀번호 관리자)로 앱에서 복구할 수 있고 그 반대도 됩니다. 앱 SDK는 서비스 앱 안에서 조각을 다루므로, Authon 혼자서는 지갑을 쓸 수 없지만 앱 코드는 사용자가 서명하는 순간 키에 접근할 수 있습니다.
서버가 세션을 가진 구조(BFF)
브라우저에 Authon 세션이 없으면 서버에서 5분짜리 지갑 전용 토큰을 발급해 넘깁니다. 이 토큰은 지갑 API에만 쓸 수 있습니다.
wallet-token.ts
// Server (Next.js route handler)
import { createAuthonWalletToken } from '@authon/nextjs/server';
export async function GET() {
const userId = await getSignedInUserId(); // from your own session
return Response.json(await createAuthonWalletToken({ userId, secretKey: process.env.AUTHON_SECRET_KEY! }));
}
// Browser
const authon = new Authon('pk_live_...', {
sessionMode: 'bff',
wallet: {
autoCreate: true,
getToken: () => fetch('/api/wallet-token').then((r) => r.json()).then((b) => b.token),
},
});