Triển khai ứng dụng đầu tiên lên server bằng erpc worker

Điều kiện tiên quyết

• Một tài khoản ERPC, đã đăng nhập trên máy này bằng erpc login (Đăng nhập và khóa).
• ERPC Credit, cho một VPS theo giờ mới. Sản phẩm theo giờ được thanh toán bằng ERPC Credit mua trước, và một lần kích hoạt mà credit không đủ chi trả sẽ bị từ chối. Giá được niêm yết tại Bảng giá và trên ERPC Web Dashboard.
• Một khóa SSH trên máy này: ssh-keygen -t ed25519, hoặc erpc config set ssh_key <path>.pub cho một khóa bạn đã có.
• Một cách để build cho Linux. Từ Mac hoặc Windows: target Rust cho server (rustup target add x86_64-unknown-linux-gnu), zig (brew install zig trên macOS) và cargo-zigbuild (cargo install cargo-zigbuild --locked). Từ một máy Linux cùng loại với server (x86-64 với mọi server ERPC): không cần gì ngoài cargo. Nếu không có các công cụ cross-build, ứng dụng được build bằng toolchain của chính máy này, và khi đó binary cần phiên bản glibc đã dùng khi liên kết nó, phiên bản mà build và deploy sẽ nêu ra. Khi có các công cụ này, ứng dụng được build cho glibc 2.31 trở lên.

Triển khai HelloWorld

erpc worker init --template helloworld   # makes ./hello-world
erpc worker run hello-world              # here: curl http://127.0.0.1:3000/
erpc worker deploy hello-world           # your VPS, or a new hourly one (price asked first)
erpc worker api / --dir hello-world      # {"message":"Hello, World!",…} from the server

erpc worker init --template helloworld   # makes ./hello-world
erpc worker run hello-world              # here: curl http://127.0.0.1:3000/
erpc worker deploy hello-world           # your VPS, or a new hourly one (price asked first)
erpc worker api / --dir hello-world      # {"message":"Hello, World!",…} from the server

1. init tạo ứng dụng trong ./hello-world, kèm erpc.toml của nó.
2. run build ứng dụng và chạy nó trên máy của bạn, để bạn có thể gọi thử bằng curl trước.
3. deploy build ứng dụng cho server và triển khai nó. Mọi thứ tốn tiền đều được hiển thị trước, kèm giá theo giờ, số dư của bạn và thời gian credit còn đủ dùng, và ở terminal, nó chỉ bắt đầu sau khi bạn đồng ý.
4. api gọi API của ứng dụng đã triển khai từ máy của bạn, trong khi API vẫn nằm trên loopback của server.

Chọn template

• HelloWorld là template nên dùng để bắt đầu.
• HFT và pumpfun-bot hiện tại đều được tạo từ template pumpfun: một trading bot cho pump.fun (PumpSwap) được port từ ValidatorsDAO/solana-stream.

erpc login                             # once per machine: the session in 1Password or the keychain
erpc worker init                       # pick with the arrow keys; makes ./<name> with erpc.toml
cd <name>
erpc worker key new                    # the trading key, in 1Password, the keychain or the keystore; prints the public key to fund
erpc worker secret put API_TOKEN --generate          # the bot's own API token, made for you and shown to nobody
erpc worker secret put ERPC_API_KEY --from-account   # the account's RPC key, read from your account (or SOLANA_RPC_ENDPOINT in [vars])
erpc worker check                      # what erpc.toml describes, and what is missing
erpc worker run --grpc --ip <IPV4>     # build and run here, with an hourly gRPC line letting this machine in
erpc worker run --check --grpc --ip <IPV4>   # the same, stopped once healthy
erpc worker deploy --new-vps --grpc    # a new hourly VPS and gRPC line, prices asked first

erpc login                             # once per machine: the session in 1Password or the keychain
erpc worker init                       # pick with the arrow keys; makes ./<name> with erpc.toml
cd <name>
erpc worker key new                    # the trading key, in 1Password, the keychain or the keystore; prints the public key to fund
erpc worker secret put API_TOKEN --generate          # the bot's own API token, made for you and shown to nobody
erpc worker secret put ERPC_API_KEY --from-account   # the account's RPC key, read from your account (or SOLANA_RPC_ENDPOINT in [vars])
erpc worker check                      # what erpc.toml describes, and what is missing
erpc worker run --grpc --ip <IPV4>     # build and run here, with an hourly gRPC line letting this machine in
erpc worker run --check --grpc --ip <IPV4>   # the same, stopped once healthy
erpc worker deploy --new-vps --grpc    # a new hourly VPS and gRPC line, prices asked first

Chọn server

1. server mà [env.<name>] của ứng dụng đã chỉ định;
2. --vps <id>, một ERPC VPS trong tài khoản của bạn;
3. --new-vps, VPS theo giờ rẻ nhất ở khu vực gần máy này nhất, xác định theo múi giờ của máy (--region và --plan chọn khác);
4. --host <address>, một server của riêng bạn: Ubuntu hoặc Debian có systemd, nftables, sudo và Python 3 tại /usr/bin/python3, truy cập bằng root hoặc một người dùng có sudo không cần mật khẩu;
5. nếu không có các mục trên, ở terminal: danh sách các VPS đang chạy trong tài khoản của bạn, với "start a new one" ở cuối.

Triển khai khi không có người ở terminal

erpc worker deploy hello-world --new-vps --yes                     # no key: all the way, unattended
erpc worker deploy pump-sniper --new-vps --grpc --yes --prepare    # a bot: everything but its key
erpc worker deploy pump-sniper                                     # then you, at a terminal: the key, and the start

erpc worker deploy hello-world --new-vps --yes                     # no key: all the way, unattended
erpc worker deploy pump-sniper --new-vps --grpc --yes --prepare    # a bot: everything but its key
erpc worker deploy pump-sniper                                     # then you, at a terminal: the key, and the start

• --yes trả lời câu hỏi về giá của từng sản phẩm theo giờ mà lệnh nêu tên (--new-vps, --grpc, --shreds, --unlimited). Nó cũng trả lời cho lần đăng nhập đầu tiên vào một server mà erpc chưa chuyển sang chỉ đăng nhập bằng khóa, dù là server mới hay server được chỉ định bằng --vps <ID>: erpc đăng nhập một lần bằng mật khẩu của server, đặt khóa của bạn vào và tắt đăng nhập bằng mật khẩu. Không có --yes và không có terminal, một lần kích hoạt sẽ bị từ chối trước khi mua bất cứ thứ gì, với trạng thái thoát 3.
• Việc chọn giữa các server của bạn vẫn cần có người. Hãy chỉ định server bằng --new-vps, --vps <ID> hoặc --host.
• --prepare làm mọi việc không cần đến khóa trading lẫn secret, và không khởi động, dừng hay khởi động lại thứ gì. Lần erpc worker deploy tiếp theo ở terminal sẽ giao khóa và các secret rồi khởi động ứng dụng. Khóa trading chỉ được đọc khi có người ở terminal.

Kết nối ứng dụng với gRPC, Shreds và Unlimited RPC

• Mỗi đường truyền là gói rẻ nhất trong nhóm của nó, trừ khi --grpc-plan, --shreds-plan hoặc --unlimited-plan chỉ định một gói.
• Unlimited RPC chạy trên một server chuyên dụng, mất tối đa 45 phút để chuẩn bị. Nó phục vụ sendTransaction và một danh sách ngắn các lệnh đọc, không phục vụ getProgramAccounts hay getTokenAccountsByOwner. Endpoint của nó là HTTP thuần (không TLS) và chỉ chấp nhận địa chỉ đã được whitelist.

Đường truyền cho một lần chạy trên máy của bạn

• Địa chỉ: các đường truyền chấp nhận địa chỉ IPv4 công khai của máy này, mà bạn truyền vào bằng --ip. erpc không tự tra cứu địa chỉ này.
• Mua: một đường truyền mới chỉ được mua ở terminal, sau khi giá của nó được hiển thị. run không có --yes.
• Kết thúc: khi lần chạy kết thúc, từng đường truyền theo giờ được kết thúc sau khi hỏi. --keep-lines giữ chúng lại, và chúng vẫn bị tính phí. Nếu lần chạy kết thúc theo cách khác (terminal bị đóng, Ctrl-C lần thứ hai), các đường truyền vẫn còn và bị tính phí.
• Số liệu: những gì ứng dụng đo được tại đây bao gồm cả khoảng cách từ máy này đến đường truyền, nên chậm hơn so với cùng ứng dụng đó chạy trên một server ở gần đường truyền.

Bước tiếp theo

• Nhập ứng dụng: Triển khai một ứng dụng bạn đã có, viết bằng bất kỳ ngôn ngữ nào.
• Khóa và secret: Giữ khóa trading và các secret ngoài ổ đĩa của server.
• Tường lửa và WAF: Đặt một API công khai phía sau WAF.
• Trạng thái và thanh toán: Theo dõi ứng dụng và xem chi phí theo giờ.