p2phelper 는 비트코인 p2p 거래 과정을 자동화하여 보다 쉽고 빠르게 판매자와 구매자가 비트코인 거래를 수행할 수 있도록 도와주는 텔레그램 봇입니다.
텔레그램 봇은 @BotFather 봇을 이용해 생성합니다. 아래와 같이 /newbot 명령을 입력한 후 봇의 이름 그리고 username 을 차례대로 입력하면 새로운 봇 생성이 완료됩니다
프로젝트 루트에 .env.sample 파일을 복사하여 .env 파일을 만들고 위에서 생성한 텔레그램 봇의 username 과 bot token 을 .env 파일에 환경변수로 저장합니다.
TELEGRAM_BOT_USERNANE="p2phelper_tmp_bot"
TELEGRAM_BOT_TOKEN="8259361687:AxxxHKxxxxlC7IhhKCxxxxDy3Oe8xXBMSj4"
ENC_SECRET="blabla-secret"
ENC_SECRET값은 길이나 형식에 제한이 없으며 판매자의 지갑 api-key 와 PushBullet key 를 암호화하고 복호화하는데 사용됩니다.- 특별히
TELEGRAM_BOT_TOKEN과ENC_SECRET값은 외부에 노출되지 않도록 주의합니다.
src/biz/config.ts 에서 운영자 본인의 라이트닝 주소를 입력합니다.
export const ADMIN_ADDRESS = 'p2phelper@blink.sv'
ADMIN_ADDRESS는 판매자 등록시 판매자 지갑 api-key 의 출금 권한을 확인하기 위해 라이트닝 출금 주소로 사용되고 거래 수수료 설정시 거래 수수료를 입금받을 주소로도 사용됩니다.
서버에 Node.js 가 설치되어 있지 않다면 Node.js 를 먼저 설치해 줍니다.
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
- Node.js 20.9.0 이상 설치
- Node.js 설치 방법은 OS 별로 다를 수 있습니다. OS 별 Node.js 설치 방법은 LLM의 도움을 받으시기 바랍니다.
- p2phelper 는 Node.js 를 사용할 수 있는 환경이라면 어디서든 구동이 가능하지만 보다 안정적인 서비스 환경을 지원하기 위해 전용 서버 머신에서 운영하실 것을 권장합니다.
git clone https://github.com/toshi0010/p2phelper.git
- 기기에 git 이 설치되어 있지 않다면 git 을 먼저 설치하셔야 합니다
여기부터는 프로젝트의 설치 경로에서 아래 명령을 차례로 수행합니다. 프로젝트 최초 설치시 또는 이후 버젼 업데이트시 한번만 수행합니다.
npm install
npm run build
다음 명령으로 p2phelper 를 시작합니다.
npm start
또는 백그라운드 서비스로 시작하려면 아래 명령으로 p2phelper 를 시작합니다
nohup npm start &
프로젝트 개발에 함께 참여하길 원한다면 아래 문서를 참고해 주세요.
- 본 서비스 운영 중 발생할 수 있는 문제나 피해에 대해 개발자는 어떠한 책임도 지지 않습니다. 서비스를 충분히 검증하고 안정적으로 운영할 수 있는 분만 사용하시기 바랍니다.
- 결제 시스템은 매우 민감한 관리가 필요한 영역입니다. 운영 과정에서 발생하는 실수나 오류로 발생한 실제 외부 결제 처리는 되돌릴 수 없으니 각별한 주의가 필요합니다.
- 코드에는 아직 발견되지 않은 버그나 오류가 존재할 수 있습니다. 사용 전 충분한 테스트와 검증이 필요합니다.
- 반복적인 비트코인 P2P 거래는 법률적으로 문제 될 소지가 있습니다. 법적 이슈가 될 수 있는 사안들에 대해서는 전문가 상담을 미리 받아보기 권하며 이에 따른 법적 책임은 사용자 본인에게 있습니다.
이 프로젝트는 MIT 라이선스로 배포됩니다. 자세한 내용은 루트의 LICENSE 파일을 참고하세요.
요약된 사용 요건:
- 저작권 고지와 허가 고지를 모든 사본 또는 상당 부분에 포함해야 합니다.
- 소프트웨어는 “있는 그대로(AS IS)” 제공되며, 어떠한 보증도 제공되지 않습니다.
- 사용, 복제, 수정, 병합, 발행, 배포, 재라이선스, 판매가 허용됩니다.
저작권자: toshi © 2025
p2phelper는 중앙의 통제나 간섭 없이, 누구나 자유롭고 편리하게 비트코인을 주고받을 수 있는 p2p 거래 환경을 만들어 갑니다.
여러분의 후원은 이 자유의 네트워크를 더욱 단단하게 세우는 힘이 됩니다.
프로젝트 후원: p2phelper@blink.sv