photon

Photon: Solana の ZK 圧縮のインデクサー

Photon は、Solana ブロックチェーン上の ZK Compression のコア インデクサーです。迅速なインデックス作成機能、スナップショットのサポート、およびローカルおよび運用環境の展開に対応する柔軟なデータベース オプションを提供します。

クイックスタート

インストール

1. 依存関係をインストールします。

sudo apt install -y build-essential pkg-config libssl-dev

2. photon-indexerをインストールします。

cargo install photon-indexer

?使用法

基本的な使い方

• ローカルネットに対してデフォルト設定で Photon を実行します。

photon

構成

• Devnet に接続します。

photon --rpc-url=https://api.devnet.solana.com

• ブロック ストリーミングに gRPC を使用します (GRPC_X_TOKEN 環境変数が必要):

photon --rpc-url=https://api.devnet.solana.com --grpc-url= < grpc_url >

• ローカルの Postgres データベースを使用します。

photon --db-url=postgres://postgres@localhost/postgres

• 開始スロットを指定します。

photon --start-slot=123

• より高度なオプションについては、次のとおりです。

photon --help

?スナップショット

Photon は、迅速なブートストラップのためのスナップショットをサポートしています。

スナップショットのロード

1. スナップショットをダウンロードします。

photon-snapshot-loader --snapshot-dir= ~ /snapshot --snapshot-server-url=https://photon-devnet-snapshot.helius-rpc.com

2. スナップショットを使用して Photon を実行します。

photon --snapshot-dir= ~ /snapshot --rpc-url=https://api.devnet.solana.com --db-url=postgres://postgres@localhost/postgres

スナップショットの作成

ローカル スナップショットを作成します。

photon-snapshotter --snapshot-dir= ~ /snapshot

スナップショットを R2 バケットに保存します。

photon-snapshotter --r2-bucket=some-bucket --r2-prefix=prefix

注: R2 を使用する場合は、 R2_ACCESS_KEY 、 R2_ACCOUNT_ID 、およびR2_SECRET_KEY環境変数を設定します。

⁉️ データベース管理

Photon は Postgres と SQLite の両方をサポートしています。デフォルトでは、インメモリ SQLite データベースが使用されます。

カスタム データベースを使用するには:

 export DATABASE_URL= " postgres://postgres@localhost/postgres "
photon-migration up
photon --db-url= $DATABASE_URL 

地域開発

テストの実行

1. 環境をセットアップします。

 export MAINNET_RPC_URL=https://api.mainnet-beta.solana.com
export DEVNET_RPC_URL=https://api.devnet.solana.com
export TEST_DATABASE_URL= " postgres://postgres@localhost/postgres "

2. 追加のツールをインストールします。

npm install -g @apidevtools/swagger-cli
wget https://dl.min.io/server/minio/release/linux-amd64/minio
chmod +x minio
docker run -p 3001:3001 docker.io/pmantica1/light-prover:1

3. テストを実行します。

cargo test

注: すべての移行は、Postgres と SQLite の両方のテスト中に自動的に実行されます。

データベースモデルの生成

cargo install sea-orm-cli --version 0.10.6
sea-orm-cli generate entity -o src/dao/generated

APIドキュメント

OpenAPI スキーマを生成します。

cargo run --bin=photon-openapi

?サポート

サポートや質問については、Github で問題を開くか、Helius discord にお問い合わせください。