メインコンテンツまでスキップ

デバイス

各アカウントが特定のデバイスに縛られることなく情報を送受信し他のアカウントと通信できるよう、すべてのアカウントにはすべてのデバイスが認識できる中央キーが作成されます。中間コードは32バイトの初期シードからランダムに生成されます。このキーは、アカウントの指定されたデバイスのみが読み取れるよう暗号化されます。

SOURCE
SEED
32 bytes random
SCRYPT
SCRYPT
ASYMMETRIC
X25519 Key Pair
Public + Private key for inter-account encryption
salt: "EDH-Derived-NaCl-X25519"
SYMMETRIC
Secret Key
NaCl SecretBox key for file encryption
salt: "EDH-Derived-NaCl-Secret"
SCRYPT (N=16384, r=8, p=1)

SEEDがランダム化された後、以下のように別のキーコードを計算できます。

X25519鍵ペア : SCRYPT(SEED, "EDH-Derived-NaCl-X25519")

対称暗号化キー : SCRYPT(SEED, "EDH-Derived-NaCl-Secret")

鍵導出関数は以下のパラメーターを使用します。

  • アルゴリズム：SCRYPT
  • SCRYPTパラメーターN（コスト）：16,384
  • SCRYPTパラメーターr（ブロックサイズ）：8
  • SCRYPTパラメーターp（並列化）：1

すべてのキーを計算した後、アカウントは公開鍵部分をコントラクトレジストリに保存し、他のアカウントがそれを使用してアカウント間でデータを暗号化できるようにします。

Device Keys​

Each device generates its own key pair, separate from the account's central keys:

  • Ethereum Wallet: A keypair used for transaction signing and on-chain identity.
  • NaCl Keypair: An X25519 keypair used for encrypting data between devices.

A device's private keys are stored only on the device itself. Ever does not store any user private keys.

デバイス管理​

アカウントへのデバイスの追加または削除には、以下の主要なプロセスが含まれます：

  1. EDHAccountにデバイスのアドレスと公開鍵を追加する。このステップでは、EDHAccountコントラクトでアカウント情報を編集する権限を持つデバイスのアドレスを追加/削除します。
  2. アカウントの中央キーを共有または失効させる。新しいデバイスが異なるアカウントの中間キーを生成するためのSEEDを認識できるよう、SEEDデータを新しいデバイスに送る必要があります。開発者はSeedVaultを経由せずにSEEDを配送する方法を選択できますが、EverはSeedVaultを使用できる参照ベースとして組み込んでいます。

デバイスを失効させるには、アカウントの新しいSEEDと中央キーのセットを作成します。次に、すべてのデバイスに新しいSEEDを共有します。アカウントから削除されたデバイスは除外します。

SeedVaultコントラクト​

アカウントの中央キー用SEEDを他のデバイスに送信する方法は、アカウント登録の範囲を超えています。また、QRコードを介したデータ送信や集中型サービスを介した送信などのプロセス選択はシステム開発者の選択です。ただし、Everはブロックチェーンを使用して集中管理キーを共有・管理する手段としてSeedVaultコントラクトを作成しました。 以下の手順で行います：

  1. アカウントにリンクされた各デバイスについて、Nacl.box関数を使用してSEEDを暗号化し、以下のキーを使用します。
    • デバイスのX25519公開鍵、および
    • 新しいSEEDから計算されたX25519秘密鍵
  2. 古いSEEDがある場合は、新しいSEEDから計算された対称キーで古いSEEDを暗号化します。
  3. 両方の暗号化データをブロックチェーン上のSeedVaultコントラクトに保存します。
SeedVault Encryption Flow
SEED
32 bytes random
derive
derive
Asymmetric Path
X25519 Secret Key
Account private key
Encrypt per Device
NaCl.box(SEED, devicePubKey, accountSecKey)
Device X25519 Public Key
From each device
Symmetric Path
Symmetric Secret Key
NaCl SecretBox key
Encrypt Old SEED
secretbox(oldSeed, newSymKey)
if old SEED exists
Publish to SeedVault
Store on blockchain
Both encrypted values are stored in the SeedVault smart contract on-chain

アカウント間通信の暗号化​

ユーザーがアカウントを持ち、2つのアカウント間でデータを送信したい場合、送信者は宛先アカウントのX25519公開鍵とソースアカウントの秘密鍵を使用して暗号化されたデータを転送できます。 NaclのSealed Box関数を暗号化と復号化に使用でき、以下のシグネチャを持ちます：

nacl.box(message, nonce, devicePublicKey, accountNewSecretKey)

インターフェース：SeedVault​

contract SeedVault {

    event EDHVaultKeyUpdated(address indexed _account, address _updater, bytes32 publicKey, address [] devices);

    function addAccountSeed(
        bytes32 encryptionPublicKey,
        bytes32 previousEncryptionPublicKey,
        bytes memory previousSeed,
        address[] memory devices,
        bytes[] memory seeds
    ) external;

    function addDeviceAccountSeed(
        address accountAddress,
        bytes32 encryptionPublicKey,
        bytes32 previousEncryptionPublicKey,
        bytes memory previousSeed,
        address[] memory devices,
        bytes[] memory seeds
    ) external;

    function getDeviceVaultSeeds(address deviceAddress)
        external view returns(DeviceSeedView[] memory);

    function getVaultSeeds(address accountAddress, address deviceAddress)
        external view returns (DeviceSeedView[] memory seeds);

    function getVaultSeedsAt(address accountAddress, address deviceAddress, uint offset, uint count)
        external view returns (DeviceSeedView[] memory seeds);
}

Event EDHVaultKeyUpdated : 公開鍵が更新されたときに生成されるイベントです。

addAccountSeed/addDeviceAccountSeed : シードを変更したり、新しいデバイスのシードを追加したりするためのトランザクション関数です。

getDeviceVaultSeeds/getVaultSeeds/getVaultSeedsAt : アカウント内のデバイスのシード値を読み取るビュー関数です。

Device Recovery​

Scenario 1: A Single Device Is Lost (Other Active Devices Remain)​

  1. Use a remaining active device to call revokeDevice to revoke the lost device.
  2. The system automatically generates a new SEED (SEED rotation).
  3. New central keys are derived from the new SEED.
  4. The SeedVault is updated with the new SEED for all remaining devices.
  5. Call updateEncryptionPublicKey on the EDHAccount to store the new public key.
  6. (Optional) Register a new device to replace the lost one.

Scenario 2: All Devices Are Lost (Backup SEED Required)​

  1. Set up a new device by generating a new Ethereum keypair and NaCl keypair.
  2. Import the backup SEED that was previously stored (32 bytes).
  3. Derive the central keys from the SEED to prove ownership of the account.
  4. Use the Emergency Guardian or social recovery mechanism to register the new device.
危険

If the backup SEED is lost and all active devices are unavailable, the account cannot be recovered. Users should always store their SEED backup in a secure location.

Key Rotation​

Key rotation occurs when a device is revoked, ensuring that the revoked device cannot read any new data.

Process​

  1. Generate a new SEED: Randomly generate a new 32-byte SEED.
  2. Derive new keys: Use SCRYPT derivation to create a new X25519 keypair and symmetric key.
  3. Update the EDHAccount: Call updateEncryptionPublicKey to store the new public key.
  4. Update the SeedVault: Encrypt the new SEED for each remaining active device, and encrypt the old SEED with the symmetric key derived from the new SEED.
  5. Update Account Storage: Re-encrypt the EVFS root key with the new key.

Accessing Old Files​

After key rotation, files encrypted with previous keys remain accessible because:

  • encryptionPublicKeys() returns all historical public keys.
  • The SeedVault stores old SEEDs encrypted with the new SEED, allowing active devices to decrypt them retroactively.
  • Files created after rotation are encrypted with the new key, so revoked devices cannot read them.

Security Best Practices​

SEED Storage​

  • Never store the SEED as plaintext on a device. Use an encrypted vault (e.g., Android Keystore, iOS Keychain).
  • Back up the SEED offline, for example by writing it on paper and storing it in a safe.
  • The SEED is not a BIP-39 mnemonic: The EDH SEED is a random 32-byte value, not a cryptocurrency wallet seed phrase.

Device Security​

  • Each device has its own Ethereum keypair -- private keys are never shared between devices.
  • A revoked device immediately loses access to the account (on the blockchain).
  • Device private keys are never exported from the device.

Risk and Mitigation Table​

ScenarioRiskMitigation
Phone stolenAttacker gains device accessRevoke device immediately, triggering SEED rotation
Server compromisedData on the server is leakedE2E encryption -- the server holds no decryption keys
SEED leakedAttacker can read dataGenerate a new SEED and revoke the compromised device
Device key leakedAttacker uses a spoofed deviceRevoke the device -- attacker loses access
Genomic data compromisedBio-anchor is forgedRevoke the bio-anchor and re-register with a new salt

See Also​