erpc worker로 첫 앱을 서버에 배포하기

사전 요구 사항

• ERPC 계정: 이 머신에서 erpc login으로 로그인되어 있어야 합니다(로그인 및 키).
• ERPC Credit: 새 시간별 과금 VPS에 필요합니다. 시간별 과금 상품은 미리 구매한 ERPC Credit으로 결제되며, Credit으로 충당할 수 없으면 시작이 거부됩니다. 가격은 요금제와 ERPC Web Dashboard에 나와 있습니다.
• SSH 키: 이 머신에 있어야 합니다. ssh-keygen -t ed25519로 만들거나, 가지고 있는 키는 erpc config set ssh_key <path>.pub로 지정하세요.
• Linux용으로 빌드할 수단. Mac이나 Windows에서는 서버용 Rust 타깃(rustup target add x86_64-unknown-linux-gnu), zig(macOS에서는 brew install zig), cargo-zigbuild(cargo install cargo-zigbuild --locked)가 필요합니다. 서버와 같은 종류의 Linux 머신(ERPC 서버는 모두 x86-64)에서는 cargo 외에 아무것도 필요 없습니다. 크로스 빌드 도구가 없으면 앱은 이 머신의 툴체인으로 빌드되며, 이때 바이너리는 링크될 때 사용한 glibc를 필요로 합니다. 그 glibc는 build와 deploy가 알려 줍니다. 크로스 빌드 도구가 있으면 glibc 2.31 이상용으로 빌드됩니다.

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은 ./hello-world에 앱을 만들고, 그 erpc.toml도 함께 만듭니다.
2. run은 앱을 빌드해 이 머신에서 실행하므로, 먼저 curl로 호출해 볼 수 있습니다.
3. deploy는 앱을 서버용으로 빌드해 배포합니다. 비용이 드는 것은 모두 시간당 가격, 잔액, Credit으로 얼마 동안 쓸 수 있는지와 함께 먼저 표시되며, 터미널에서는 yes로 답한 뒤에만 시작합니다.
4. api는 API를 서버의 loopback에 그대로 둔 채, 배포된 앱의 API를 이 머신에서 호출합니다.

템플릿 선택하기

• HelloWorld는 처음 시작하기에 알맞은 템플릿입니다.
• HFT와 pumpfun-bot은 현재로서는 둘 다 pumpfun 템플릿으로 만들어집니다. ValidatorsDAO/solana-stream에서 이식한 pump.fun(PumpSwap) 트레이딩 봇입니다.

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

서버 선택하기

1. 앱의 [env.<name>]에 이미 지정된 서버
2. --vps <id>: 계정의 ERPC VPS
3. --new-vps: 이 머신의 시간대로 판단해 가장 가까운 리전에서 가장 저렴한 시간별 과금 VPS(--region과 --plan으로 다르게 고를 수 있습니다)
4. --host <address>: 직접 보유한 서버. systemd, nftables, sudo, 그리고 /usr/bin/python3의 Python 3이 있는 Ubuntu 또는 Debian이어야 하며, root 또는 비밀번호 없이 sudo를 쓸 수 있는 사용자로 접속합니다.
5. 그 밖의 경우, 터미널에서는 계정에서 실행 중인 VPS 목록이 표시되고 맨 끝에 "start a new one"이 있습니다.

터미널 앞에 사람이 없을 때 배포하기

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는 명령이 지정한 각 시간별 과금 상품(--new-vps, --grpc, --shreds, --unlimited)의 가격에 응답합니다. erpc가 아직 키 전용으로 만들지 않은 서버, 즉 새 서버나 --vps <ID>로 지정한 서버에 대한 첫 로그인에도 응답합니다. erpc는 서버의 비밀번호로 한 번 로그인해 사용자의 키를 넣고 비밀번호 로그인을 끕니다. --yes도 터미널도 없으면 무엇이든 구매하기 전에 시작이 거부되며, 종료 상태는 3입니다.
• 여러 서버 중에서 고르는 일에는 여전히 사람이 필요합니다. --new-vps, --vps <ID>, --host로 서버를 지정하세요.
• --prepare는 트레이딩 키도 시크릿도 필요 없는 작업을 모두 수행하며, 아무것도 시작·중지·재시작하지 않습니다. 다음에 터미널에서 erpc worker deploy를 실행하면 키와 시크릿을 넘기고 앱을 시작합니다. 트레이딩 키는 터미널 앞에 사람이 있을 때만 읽습니다.

앱을 gRPC, Shreds, Unlimited RPC에 연결하기

• --grpc-plan, --shreds-plan, --unlimited-plan으로 요금제를 지정하지 않는 한, 각 회선에는 같은 계열에서 가장 저렴한 것이 사용됩니다.
• Unlimited RPC는 준비되기까지 최대 45분이 걸리는 전용 서버에서 실행됩니다. sendTransaction과 소수의 읽기 메서드를 제공하며, getProgramAccounts나 getTokenAccountsByOwner는 제공하지 않습니다. 엔드포인트는 일반 HTTP(TLS 없음)이며, 화이트리스트에 등록된 주소만 허용합니다.

이 머신에서 실행할 때의 회선

• 주소: 회선은 이 머신의 공인 IPv4 주소를 허용하며, 그 주소는 --ip로 전달합니다. erpc가 직접 조회하지는 않습니다.
• 구매: 새 회선은 가격이 표시된 뒤 터미널에서만 구매됩니다. run에는 --yes가 없습니다.
• 종료: 실행이 끝나면 각 시간별 회선은 확인을 거친 뒤 종료됩니다. --keep-lines를 주면 회선이 유지되며 계속 과금됩니다. 실행이 다른 방식으로 끝나면(터미널을 닫거나 Ctrl-C를 한 번 더 누른 경우) 회선은 남아 있고 과금됩니다.
• 수치: 여기서 앱이 측정하는 값에는 이 머신에서 회선까지의 거리가 포함되므로, 회선 가까이에 있는 서버에서 실행하는 같은 앱보다 느립니다.

다음 단계

• 앱 가져오기: 이미 가지고 있는 앱을 언어에 관계없이 배포합니다.
• 키 및 시크릿: 트레이딩 키와 시크릿을 서버의 디스크에 두지 않습니다.
• 방화벽 및 WAF: 공개 API를 WAF 뒤에 둡니다.
• 상태 및 요금 청구: 앱을 지켜보고 시간당 비용을 확인합니다.