What is POKT Gateway Server?

The POKT Gateway Server is a comprehensive solution designed to simplify the integration of applications with the POKT Network. Our goal is to reduce the complexities associated with directly interfacing with the protocol, making it accessible to a wide range of users, including application developers, existing centralized RPC platforms, and future gateway operators.

Learn more about the vision and overall architecture overview

Gateway Operator Quick Getting Started

To onboard the gateway server without having to dig deep, you can follow the Quick Onboarding Guide

Interested in learning more? We have an abdundance of information in docs

1. Gateway Server Overview
2. Gateway Server API Endpoints
3. Gateway Server System Architecture
4. Gateway Server Node Selection
5. POKT Primer
6. POKT's Relay Specification

Docker Image Releases

Every release candidate is published to https://github.com/pokt-network/gateway-server/pkgs/container/pocket-gateway-server

Docker Compose

There is an all-inclusive docker-compose file available for development docker-compose.yml

Minimum Hardware Requirements to run

• 1GB of RAM
• 1GB of storage
• 4 vCPUs

Creating a DB Migration

Migrations are like version control for your database, allowing your team to define and share the application's database schema definition. Before running a migration make sure to install the go lang migration cli on your machine. https://github.com/golang-migrate/migrate/tree/master/cmd/migrate

./scripts/migration.sh -n {migration_name}

This command will generate a up and down migration in db_migrations

Applying a DB Migration

DB Migrations are applied upon server start, but as well, it can be applied manually through:

./scripts/migration.sh {--down or --up} {number_of_times} 
./scripts/migration.sh -d 1
./scripts/migration.sh -u 1

Running Tests

Install Mockery with

go install github.com/vektra/mockery/v2@v2.40.1

You can generate the mock files through:

./scripts/mockgen.sh

By running this command, it will generate the mock files in ./mocks folder. Reference for mocks can be found here https://vektra.github.io/mockery/latest/

Run this command to run tests:

go test ./...

Generating DB Queries

Gateway server uses PGGen to create autogenerated type-safe queries. Queries are added inside queries.sql and then regenerated via ./scripts/querygen.sh.

Contributing Guidelines

1. Create a Github Issue on the feature/issue you're working on.
2. Fork the project
3. Create new branch with git checkout -b "branch_name" where branch name describes the feature.
   • All branches should be based off main
4. Write your code
5. Make sure your code lints with go fmt ./... (This will Lint and Prettify)
6. Commit code to your branch and issue a pull request and wait for at least one review.
   • Always ensure changes are rebased on top of main branch.

---

Project Structure

• cmd: Contains the entry point of the binaries
  • gateway_server: HTTP Server for serving requests
• internal: Shared internal folder for all binaries
• pkg: Distributable dependencies
• docs: Project documentation and specifications