photon

Photon: o indexador para compressão ZK em Solana

Photon é o indexador principal para compressão ZK no blockchain Solana. Ele oferece recursos de indexação rápida, suporte a snapshots e opções flexíveis de banco de dados para atender implantações locais e de produção.

Início rápido

Instalação

1. Instale dependências:

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

2. Instale photon-indexer :

cargo install photon-indexer

? Uso

Uso Básico

• Execute o Photon com configurações padrão na rede local:

photon

Configuração

• Conecte-se ao Devnet:

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

• Use gRPC para streaming de bloco (requer a variável de ambiente GRPC_X_TOKEN):

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

• Use um banco de dados Postgres local:

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

• Especifique um slot inicial:

photon --start-slot=123

• Para opções mais avançadas:

photon --help

? Instantâneos

Photon oferece suporte a instantâneos para inicialização rápida.

Carregando um instantâneo

1. Baixe um instantâneo:

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

2. Execute o Photon com o instantâneo:

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

Criando instantâneos

Crie um instantâneo local:

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

Armazene snapshots em um bucket R2:

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

Nota: Defina as variáveis ​​de ambiente R2_ACCESS_KEY , R2_ACCOUNT_ID e R2_SECRET_KEY ao usar R2.

?️ Gerenciamento de banco de dados

Photon suporta Postgres e SQLite. Por padrão, ele usa um banco de dados SQLite na memória.

Para usar um banco de dados personalizado:

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

Desenvolvimento Local

Executando testes

1. Configure o ambiente:

 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. Instale ferramentas adicionais:

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. Execute testes:

cargo test

Nota: Todas as migrações são executadas automaticamente durante os testes para Postgres e SQLite.

Geração de modelo de banco de dados

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

Documentação da API

Gere esquemas OpenAPI:

cargo run --bin=photon-openapi

? Apoiar

Para suporte ou dúvidas, abra um problema no Github ou entre em contato com o discord Helius.