photon

Photon：Solana 上的 ZK 壓縮索引器

Photon 是 Solana 區塊鏈上 ZK 壓縮的核心索引器。它提供快速索引功能、快照支援和靈活的資料庫選項，以滿足本地和生產部署的需求。

快速入門

安裝

1. 安裝依賴項：

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

2. 安裝photon-indexer ：

cargo install photon-indexer

？用法

基本用法

• 針對本機網路使用預設設定執行 Photon：

photon

配置

• 連接到開發網：

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。