photon

Photon: Solana의 ZK 압축용 인덱서

Photon은 솔라나 블록체인의 ZK 압축을 위한 핵심 인덱서입니다. 신속한 인덱싱 기능, 스냅샷 지원, 유연한 데이터베이스 옵션을 제공하여 로컬 및 프로덕션 배포에 적합합니다.

빠른 시작

설치

1. 종속성을 설치합니다.

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

2. photon-indexer 설치:

cargo install photon-indexer

? 용법

기본 사용법

• localnet에 대해 기본 설정으로 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에 문의하세요.