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。