メインコンテンツへスキップ
GitHub Container Registryで公開されているDockerイメージをご利用いただけます。 
docker run -p 7500:7500 -e SEQUENCE_PROJECT_ACCESS_KEY=... ghcr.io/0xsequence/sidekick:latest
これで、最小限の機能を備えたローカルSidekickバックエンド（ポート7500）が起動します。
SEQUENCE_PROJECT_ACCESS_KEY の設定も推奨していますが、テスト目的の場合はデフォルトのキーも利用できます。ご自身のキーはSequence Builderから取得できます。

​
バックエンドウォレット

Sidekickは、指定されたBACKEND_WALLET_PV_KEYまたはAWS / GCP KMS署名者に基づいてSequenceスマートコントラクトウォレットを作成します。これにより、ガス代の肩代わり（ガススポンサーシップ）、トランザクションのバッチ処理、その他の最適化が可能となります。 バックエンドウォレットの設定方法：
  • ローカル環境でセットアップする場合は、BACKEND_WALLET_PV_KEYを.envファイルに記載してください（本番環境では推奨されません）。また、指定しない場合はランダムなキーが自動生成され、dev.keyファイルに保存されます。
  • 推奨方法： AWS または GCP KMSを設定し、必要な認証情報を.envファイルに追加
ローカル、AWS、GCPウォレット構成に必要な認証情報は、env.exampleファイルをご参照ください。
AWS KMSおよびGCP KMSで正しいキータイプを選択してください。
  • AWS KMS: ECC_NIST_P256_KEY_ALIAS
  • GCP KMS: GCP_KEY_RING_NAME
SidekickはAWSおよびGCP KMSとシームレスに統合でき、KMS署名者の利用が可能です。アダプターを用意しており、AWS/GCP KMSをethersの署名者タイプと互換にし、最新バージョンにも対応しています。 Sequence Sidekickは、ブロックチェーンアプリ開発者にスケーラブルですぐ使えるバックエンドソリューションを提供し、バックエンドの複雑さを気にせず開発に集中できます。
Sequence Sidekickを利用する際の注意点：
  • msg.senderはあなたのEOAのSequenceウォレットアドレスとなり、EOAアドレスそのものではありません。
  • tx.originはSequenceリレイヤーアドレスのいずれかになります。
  • コントラクト関数呼び出しの際は、Sequenceウォレットアドレスに適切な権限が付与されていることを確認してください。
  • メインネットステータスページでアクティブなリレイヤーアドレスを確認できます。

​
開発モードでSidekickを起動する

1

Sidekickリポジトリをクローンする

git clone https://github.com/0xsequence/sidekick
2

必要な環境変数を設定する

​
必須環境変数

変数説明
PROJECT_ACCESS_KEYSequence Builder APIキーから取得したアクセスキー

​
オプションの環境変数

変数説明
BACKEND_WALLET_PV_KEYトランザクション署名に使用するEOAの秘密鍵
PORTSidekickサーバーのポート（デフォルト: 7500）
HOSTサーバーのホストアドレス（デフォルト: 0.0.0.0）
REDIS_HOSTRedisサーバーのホスト（デフォルト: localhost）
REDIS_PORTRedisサーバーのポート（デフォルト: 6379）
REDIS_PASSWORDRedisサーバーのパスワード（任意）
DATABASE_URLSidekickデータベース用のPostgreSQL接続文字列
SIDEKICK_API_SECRET_KEYSidekick APIへの書き込みアクセスに必要なシークレットキー
ETHERSCAN_API_KEYコントラクト検証を有効にするためのEtherscan APIキー
VERIFY_CONTRACT_ON_DEPLOYデプロイ時の自動コントラクト検証を有効化（trueで有効）
DEBUGデバッグログを有効化（trueで詳細出力）
SIGNER_TYPE使用する署名者の種類（local, aws_kms, google_kms）
AWS_REGIONAWSアカウントのリージョン
AWS_ACCESS_KEY_IDAWSアクセスキーID
AWS_SECRET_ACCESS_KEYAWSシークレットアクセスキー
AWS_KMS_KEY_ID使用するKMSキーのID
PROJECTGCPプロジェクト名
LOCATIONGCPプロジェクトのロケーション
KEY_RINGキーリング名
CRYPTO_KEY暗号鍵名
CRYPTO_KEY_VERSION暗号鍵のバージョン

​
ウォレット構成用変数

以下のいずれかの構成を選択してください：

​
ローカルウォレットの場合：

変数説明
SIGNER_TYPElocal
BACKEND_WALLET_PV_KEY0x…（任意）

​
AWS KMSの場合：

変数説明
SIGNER_TYPEaws_kms
AWS_REGIONAWSアカウントのリージョン
AWS_ACCESS_KEY_IDAWSアクセスキーID
AWS_SECRET_ACCESS_KEYAWSシークレットアクセスキー
AWS_KMS_KEY_ID使用するKMSキーのID

​
GCP KMSの場合：

変数説明
SIGNER_TYPEgoogle_kms
PROJECTGCPプロジェクト名
LOCATIONGCPプロジェクトのロケーション
KEY_RINGキーリング名
CRYPTO_KEY暗号鍵名
CRYPTO_KEY_VERSION暗号鍵のバージョン
3

Dockerがインストールされていることを確認してください

こちらから入手できます
4

DockerコンテナでSidekickを起動する

pnpm docker:start
5

バックエンドウォレットアドレスの確認

curl -X GET 'http://localhost:3000/sidekick/smart-account-address'

​
Dockerを使わない開発モード

Dockerを使わずにコードベースを変更してテストしたい場合 
pnpm install
pnpm dev:withRedis
このコマンドでSidekickが起動し、Redisサーバーも同時に開始されます。

​
ガススポンサーシップ

テストネットでは、すべてのトランザクションの手数料を当社が負担しています。ただし、メインネットでは、コントラクト自体の手数料を負担することでトランザクションが正しく処理されるようにする必要があります。詳しくは、Gas Sponsorship ソリューションをご覧ください。