Skip to content

バージョンの違いについて(v1 と v2)

本ドキュメントのこの部分は、Pontus-X(v1)向けに更新されたウォレット設定手順を反映して改訂されています。Pontus-X ポータル向けの簡便なウォレットファイル設定フローに加え、2026 年に導入された Ocean Enterprise スタック(v2)の変更点も扱います。

Ocean Enterprise を基盤とする v2 では、次の 2 種類のウォレットを用いる方式が導入されました。

  1. トランザクションの署名と、スマートコントラクトやコネクタなどの Ocean Enterprise コンポーネントとのやり取りに用いる SECP256k1 鍵を保持する、参加者エージェント用ウォレット
  2. 検証可能クレデンシャルと RSA 鍵を保持する SSI ウォレット。Policy Decision Point とやり取りするための検証可能クレデンシャル/プレゼンテーションの署名や、更新されたカタログコンポーネントでのカタログ項目の署名に用います。

Pontus-X v1 のみを使う場合は、ウォレットファイルの設定だけが関係します。

Ocean Enterprise v2 を使う場合は、設定時にウォレットファイルと SSI ウォレットの両方が関係します。

ウォレットファイルの設定(v1・v2 共通)

エコシステムの参加者として始めるには、自分の秘密鍵を自ら管理し、それをウォレットに取り込む必要があります。ウォレットファイルにより、参加者は署名やスマートコントラクト操作のための秘密鍵を、ポータルなどの参加者エージェントへ読み込ませ、トランザクションの署名や送信といった操作を行えるようになります。

利用する鍵は、オフラインのウォレットファイル生成ツール で自分で作成した SECP256K1 の秘密鍵か、ファストトラックアプリケーション を用いたガイド付きオンボーディングの過程で作成した SECP256K1 の鍵のいずれかです。

SECP256K1 の秘密鍵は次のような形をしています(あくまで例であり、実際には使用しないでください)。

0d9619d1702c7a4ff89ecf37201TEST2f0d124ca503a61c5f3a60e0451236365

この秘密鍵からアカウントアドレスが導出されます。例:

0x29080D654eFD6AC00f8b26F4741E82CD0c2C0778

これが、管理対象アカウントの公開された一意の識別子になります。

ウォレットファイルは、秘密鍵を保持しパスワードで保護された、AES 暗号化済みの JSON ファイルです。

{
  "address": "29080D654eFD6AC00f8b26F4741E82CD0c2C0778",
  "id": "16646b51-1b7e-4bb8-9d7a-6deb355e34a1",
  "version": 3,
  "crypto": {
    "cipher": "aes-128-ctr",
    "cipherparams": {
      "iv": "cb6539bdcc14e8d7dbc4124eb001fad2"
    },
    "ciphertext": "207281e6e4387ce9f1e1dd6ad09ed5020776f39c94d0dec1e6bc7368247be715",
    "kdf": "scrypt",
    "kdfparams": {
      "salt": "0cfe5cbc91124c7b55e0b730c8c79503b3568e7f81c488df32cbbd04406e5e45",
      "n": 131072,
      "dklen": 32,
      "p": 1,
      "r": 8
    },
    "mac": "ddb4c4573c50ccbad79b49e1d66736c7d71ffc7a116192fd628f3bfcfd4c28aa"
  }
}

先へ進む前に、次の点にご注意ください。

  • この秘密鍵はエコシステム上のあなたのアイデンティティを支配します。安全なオフラインバックアップを作成してください。
  • 組織外の誰とも共有せず、クラウドに保存しないでください。
  • 秘密鍵の管理を失った場合は、直ちにご連絡ください。Pontus-X のフェデレーターがネットワーク上で当該鍵を拒否リストに登録し、他のデータスペース当局にも周知できるようにするためです。
  • ネットワーク上に自らのサービス提供物を公開する際、氏名やメールアドレスなどの個人情報をネットワークに保存することは認められていません。

ウォレットファイルは、広く使われている Web3 ウォレットである MetaMask にインポートすることもできます。

ウォレットファイルの利用(v1・v2 共通)

データスペースのポータルなどの参加者エージェントを開くと、そのエージェントが自分を代理するように設定を促されます。これは、ウォレットファイルを通じて秘密鍵をエージェントに読み込ませることで行います。

image.png

v1 のデータスペースポータルにおけるウォレット選択画面のスクリーンショット。

image.png

v2 のデータスペースポータルにおけるウォレット選択画面のスクリーンショット。

ウォレットファイルを選んで参加者エージェントにアップロードすると、復号のためにパスワードの入力を求められます。

image.png

v1 のデータスペースポータルにおけるウォレット復号ダイアログのスクリーンショット。

image.png

v2 のデータスペースポータルにおけるウォレット復号ダイアログのスクリーンショット。

ウォレットファイルの復号と参加者エージェントへの取り込みが成功すると、短い通知が表示され、画面右上のインジケーターで公開アドレスを確認できます。

image.png

v1 のデータスペースポータルにおけるアカウントメニューのスクリーンショット。

image.png

v2 のデータスペースポータルにおけるアカウントメニューのスクリーンショット。

取引のためのウォレットへの入金(v1・v2 共通)

データスペースエコシステムへ書き込みを伴うトランザクションを実行し、支払いを行うには、アカウントに資金を入れておく必要があります。開発・テスト環境では、これはフォーセット(Faucet)を通じて行います。フォーセットが組み込まれた Pontus-X ポータルに接続すれば、組織は初回およびその後の資金供給をフォーセット経由で申請できます。

v1 のネットワーク(Pontus-X 開発ネットおよびテストネット)では、手数料は EURAU の手数料用トークンで、支払いは EURAU の決済用トークンでまかなわれます。これは本番環境の手数料・決済構造を、実際の経済的価値を伴わずに模したものです。

v2 のネットワーク(Optimism Sepolia)では、手数料は ETH、支払いは EURAU の決済用トークンでまかなわれます。こちらも同様に、実際の経済的価値を伴わない模擬です。

本番実装では、手数料は抽象化でき、支払いは電子マネーまたは代替の決済チャネルで行えます。

SSI ウォレットと参加者エージェントの接続(v2 のみ)

v2 の参加者エージェントでは、SSI ウォレットへの接続を促されます。この接続には、直前に参加者エージェントへ読み込ませたウォレットファイルの秘密鍵が使われます。

image.png

v2 のデータスペースポータルにおける SSI ウォレット接続ダイアログのスクリーンショット。

ここでは、すでに構築済みで、必要な秘密鍵と検証可能クレデンシャルを保持し、少なくとも 1 つの DID

に紐づいた自分の SSI ウォレットを設定します。そのようなウォレットの設定(デプロイではありません)については、次章で説明します。

SSI ウォレットの設定(v2 のみ)

v2 スタックの一般公開後に記述予定です。

image.png

v2 スタックで SSI ウォレットとして用いる walt.id ウォレットのスクリーンショット。