XRPL Docs (Korean)
  • XRPL Docs(Kor)
  • Introduction
    • XRP Ledger란?
    • XRP란?
    • Crypto Wallets
    • Transactions and Requests
    • Software Ecosystem
  • Use Cases
    • 결제(Payments)
      • P2P 결제(Peer-to-Peer Payments)
      • 예금 제한(Restricting Deposits)
      • 스마트 컨트랙트(Smart Contracts)
    • 토큰화(Tokenization)
      • 스테이블코인 발행인(Stablecoin Issuer)
      • NFT 마켓플레이스 개요(NFT Marketplace Overview)
    • 탈중앙화 금융(Decentralized Finance)
      • 알고리즘 트레이딩(Algorithmic Trading)
      • 거래소에 XRP 상장하기((List XRP as an Exchange)
  • Concepts
    • 소개
      • 컨센서스 소개
      • XRP
      • 소프트웨어 생태계
    • XRP Ledger 서버
      • rippled 서버 모드(rippled Server Modes)
      • 클러스터링(Clustering)
      • Ledger 역사
      • 피어 프로토콜(Peer Protocol)
      • 트랜잭션 검열 감지(Transaction Censorship Detection)
      • 병렬 네트워크(Parallel Networks)
      • 수정안(Amendments)
        • XRP Ledger에 코드를 기여하는 방법
        • 알려진 수정안
      • 클리오 서버(The Clio Server)
    • 컨센서스 네트워크(Consensus Protocol)
      • 컨센서스 구조(Consensus Structure)
      • 컨센서스 원칙과 규칙(Consensus Principles and Rules)
      • 공격과 실패 모드에 대한 컨센서스 보호(Consensus Protections Against Attacks and Failure Modes)
      • 불변성 체크
      • 부정 UNL
      • 트랜잭션 취소 정보
      • 트랜잭션 변조 가능성
      • 수수료 투표
      • 컨센서스 연구
    • Ledgers
      • Ledger 구조(Ledger Structure)
      • 개방형, 폐쇄형, 검증형 Ledgers(Open, Closed, and Validated Ledgers)
      • Ledger 마감 시간(Ledger Close Times)
    • 트랜잭션(Transactions)
      • 수수료(Fees)
      • 신뢰할 수 있는 트랜잭션 제출(Reliable Transaction Submission)
      • 보안 서명(Secure Signing)
      • 출발, 데스티네이션 태그(Source and Destination Tags)
      • 트랜잭션 비용(Transaction Cost)
      • 트랜잭션 대기열(Transaction Queue)
      • 결과의 불변성(Finality of Results)
        • 트랜잭션 결과 조회(Look Up Transaction Results)
        • Transaction Malleability
    • 결제 유형
      • XRP 직접 결제
      • 교차 화폐 결제
      • 수표
      • 에스크로
      • 부분 결제
      • 결제 채널
    • 토큰(Tokens)
      • Non-Fungible Tokens
        • NFT 정보 저장소(NFT Payload Storage)
        • XRP Ledger에서 NFT 토큰 거래(Trading NFTokens on the XRP Ledger)
        • NFT Reserve Requirements
        • 일괄 발행(Batch minting)
        • 다른 계정에게 NFT 발행 권한 부여(Authorizing Another Account to Mint Your NFTs)
        • NFT 경매 진행하기(Running an NFT Auction)
        • NFT를 컬렉션으로 발행하기(Minting NFTs into Collections)
        • NFT의 고정 공급 보장하기(Guaranteeing a Fixed Supply of NFTs)
        • NFT 관련 API(NFT APIs)
      • 신뢰선과 발급(Trust Lines and Issuing)
      • 승인된 신뢰선(Authorized Trust Lines)
      • 토큰 환수(Clawing Back Tokens)
      • Freezing Tokens(토큰 동결)
        • 동결에 대한 일반적인 오해(Common Misunderstandings about Freezes )
      • Rippling
      • 이체 수수료(Transfer Fees)
      • 경로(Paths)
      • Demurrage(과잉보유비용)
      • 탈중앙화 거래소(Decentralized Exchange)
        • 제안(Offers)
        • Auto-Bridging
        • Tick Size
        • AMM(Automated Market Makers)
    • 계정
      • 다중 서명
      • 티켓
      • 계정 유형
      • 계정 삭제
      • 준비금(Reserves)
      • 주소(Addresses)
      • 암호화 키(Cryptographic Keys)
      • 입금 승인(Deposit Authorization)
  • Tutorials
    • 퍼블릭 서버(Public Servers)
    • Python
      • Python으로 시작하기(Get Started Using Python)
      • python 모듈형 튜토리얼(Modular Tutorials in Python)
        • python을 이용한 Send Payments(Send Payments Using Python)
          • 계정 생성 및 XRP 전송(Create Accounts and Send XRP Using Python)
          • 신뢰 생성 및 Currency 전송 (Create Trust Line and Send Currency Using Python)
          • 시간 보류 에스크로 생성(Create Time-based Escrows Using Python)
        • python을 이용한 NFTs(NFTs Using Python)
          • NFTs 발행과 소각(Mint and Burn NFTs Using Python)
          • NFTs 전송 (Transfer NFTs Using Python)
          • NFT 판매 중개 (Broker an NFT Sale Using Python)
          • 공인 발행인 지정 (Assign an Authorized Minter Using Python)
          • NFTs 일괄 발행 (Batch Mint NFTs Using Python)
        • Python에서 데스크톱 지갑 구축(Build a Desktop Wallet in Python)
    • JavaScript
      • JavaScript로 시작하기(Get Started Using JavaScript)
      • JavaScript 모듈형 튜토리얼(Modular Tutorials in JavaScript)
        • JavaScript를 이용한 Send Payments(Send Payments Using JavaScript)
          • JavaScript를 이용한 계정 생성 및 XRP 전송(Create Accounts and Send XRP Using JavaScript)
          • JavaScript를 이용한 신뢰선 생성 및 화폐 전송(Create Trust Line and Send Currency Using JavaScript)
          • 시간 기반 에스크로 생성하기(Create Time-based Escrows Using JavaScript)
          • 조건부 에스크로 생성하기(Create Conditional Escrows Using JavaScript)
        • JavaScript를 이용한 NFTs(NFTs Using JavaScript)
          • JavaScript를 이용한 NFTs 발행 및 소각(Mint and Burn NFTs Using JavaScript)
          • JavaScript를 이용한 NFTs 전송(Transfer NFTs Using JavaScript)
          • JavaScript를 이용한 NFT 판매 중개(Broker an NFT Sale Using JavaScript)
          • JavaScript를 이용한 공인 발행인 지정(Assign an Authorized Minter Using JavaScript)
          • JavaScript를 이용한 NFTs 일괄 발행(Batch Mint NFTs Using JavaScript)
      • JavaScript를 이용한 브라우저 지갑 개발(Build a Browser Wallet in JavaScript)
      • JavaScript를 이용한 데스크탑 지갑 개발(Build a Desktop Wallet in JavaScript)
    • Java
      • Java로 시작하기(Get Started Using Java)
    • HTTP / Websocket APIs
      • HTTP/WebSocket API 사용 시작하기(Get Started Using HTTP / WebSocket APIs)
      • WebSocket으로 수신 결제 모니터링(Monitor Incoming Payments with WebSocket)
    • Tasks
      • 계정 설정 관리(Manage Account Settings)
        • 일반 키 쌍 할당
        • 일반 키 쌍 변경 또는 제거
        • 마스터 키 쌍 비활성화
        • 다중 서명 설정
        • 다중 서명 트랜잭션 전송
        • 데스티네이션 태그 필요
        • 오프라인 계정 설정 튜토리얼
        • 티켓 사용(Use Tickets)
      • XRP 보내기(Send XRP)
      • 특수 결제 유형 사용(Use Specialized Payment Types)
        • 에스크로 사용(Use escrow)
          • 시간 보류 에스크로 보내기(Send a Time-Held Escrow)
          • 조건부 보류 에스크로 보내기(Send a Conditionally-Held Escrow)
          • 만료된 에스크로 취소(Cancel an Expired Escrow)
          • 에스크로 조회(Look up Escrows)
          • 에스크로를 스마트 컨트랙트로 사용(Use an Escrow as a Smart Contract)
        • 결제 채널 사용(Use Payment Channels)
          • 결제 채널을 열어 거래소 간 네트워크 활성화(Open a Payment Channel to Enable an Inter-Exchange Network)
        • 수표 사용(Use Checks)
          • 수표 전송(Send a Check)
          • 정확한 금액의 수표 현금화(Cash a Check for an Exact Amount)
          • 유연한 금액의 수표 현금화(Cash a Check for a Flexible Amount)
          • 수표 취소(Cancel a Check)
          • 발신자별 수표 조회(Look Up Checks by Sender)
          • 수취인별 수표 조회(Look Up Checks by Recipient)
      • 토큰 사용(Use Tokens)
        • 대체가능한 토큰 발행(Issue a Fungible Token)
        • 탈중앙화 거래소에서 거래(Trade in the Decentralized Exchange)
        • 동결 금지 활성화
        • 글로벌 동결 시행
        • 신뢰선 동결하기
    • Apps 구축
      • JS에서 데스크톱 지갑 구축
      • JS에서 브라우저 지갑 구축
    • XRP Ledger 비즈니스
      • XRP 차트에 거래소 등록하기
      • 스테이블코인 발행자 되기
    • rippled 서버 관리
      • rippled 설치
        • 시스템 요구 사항
        • CentOS/Red Hat에 yum으로 설치하기
        • 우분투 또는 데비안 리눅스에 설치
        • 리눅스에서 자동 업데이트
        • CentOS/Red Hat에서 수동 업데이트
        • 우분투 또는 데비안에서 수동 업데이트
        • 리포팅 모드에서 rippled 빌드 및 실행
        • 용량 계획
        • rippled v1.3.x 마이그레이션 지침
      • rippled 구성
        • rippled를 검증인으로 실행하기
        • rippled를 스톡 서버로 실행
        • 수정안 투표 구성
        • 수정안 테스트
        • StatsD 구성
        • rippled를 병렬 네트워크에 연결하기
        • 온라인 삭제 구성
        • 권고 삭제 구성
        • 히스토리 샤딩 구성
        • 전체 히스토리 구성
        • gRPC 구성
        • 공개 서명 사용
      • 피어링 구성
        • 클러스터 rippled 서버
        • 비공개 서버 구성
        • 피어 크롤러 구성
        • 링크 압축 사용
        • 피어링을 위한 포트 포워드
        • 특정 피어에 수동으로 연결
        • 최대 피어 수 설정
        • 피어 예약 사용
      • stand-alone 모드에서 rippled 기능 테스트하기
        • stand-alone 모드에서 새 제네시스 ledger 시작하기
        • stand-alone 모드에서 저장된 ledger 불러오기
        • stand-alone 모드에서 ledger 진행하기
      • 문제 해결
        • rippled 문제 진단하기
        • 상태 확인 개입
        • 로그 메시지 이해
        • rippled 서버가 동기화되지 않음
        • rippled 서버가 수정이 차단됨
        • rippled 서버가 시작되지 않음
        • SQLite 트랜잭션 데이터베이스 페이지 크기 문제 해결
    • 클리오 서버 관리
      • 우분투 리눅스에 클리오 설치
  • References
    • XRP Ledger 프로토콜 참조(XRP Ledger Protocol Reference)
      • 기본 데이터 유형(Basic Data Types)
        • base58 인코딩(base58 Encodings)
        • 화폐 형식(Currency Formats)
        • NFToken
      • Ledger 데이터 형식(Ledger Data Formats)
        • Ledger 헤더(Ledger Header)
        • Ledger 객체 IDs
        • Ledger 객체 유형
          • AccountRoot
          • Amendments
          • AMM(experimental - 수정중)
          • Check
          • DepositPreauth
          • DirectoryNode
          • Escrow
          • FeeSettings
          • LedgerHashes
          • NegativeUNL
          • NFTokenOffer
          • NFTokenPage
          • Offer
          • PayChannel
          • RippleState
          • SignerList
          • Ticket
      • 트랜잭션 참조(Transaction Reference)
        • 트랜잭션 공통 필드(Transaction Common Fields)
        • 트랜잭션 유형(Transaction Types)
          • AccountSet
          • AccountDelete
          • AMMBid
          • AMMCreate
          • AMMDelete
          • AMMDeposit
          • CheckCancel
          • CheckCash
          • CheckCreate
          • DepositPreauth
          • EscrowCancel
          • EscrowCreate
          • EscrowFinish
          • NFTokenAcceptOffer
          • NFTokenBurn
          • NFTokenCancelOffer
          • NFTokenCreateOffer
          • NFTokenMint
          • OfferCancel
          • OfferCreate
          • Payment
          • PaymentChannelClaim
          • PaymentChannelCreate
          • PaymentChannelFund
          • SetRegularKey
          • SignerListSet
          • TicketCreate
          • TrustSet
        • Pseudo-Transactions
          • EnableAmendment
          • SetFee
          • UNLModify
        • 트랜잭션 결과(Transaction Results)
          • tec Codes
          • tef Codes
          • tel Codes
          • tem Codes
          • ter Codes
          • tes Success
        • 트랜잭션 메타데이터(Transaction Metadata)
      • Binary Format
    • 클라이언트 라이브러리
      • JavaScript / TypeScript 클라이언트 라이브러
        • ripple-lib 1.x에서 xrpl.js 2.x로의 마이그레이션 가이드
      • Python 클라이언트 라이브러리
      • Java 클라이언트 라이브러리
      • Ruby 클라이언트 라이브러리
    • HTTP / WebSocket APIs
      • API 규칙
        • 요청 형식
        • 응답 형식
        • 오류 형식
        • 마커 및 페이지네이션
        • 속도 제한
        • rippled 서버 상태
      • 공개 API 메소드
        • 계정 메소드
          • account_channels
          • account_currencies
          • account_info
          • account_lines
          • account_nfts
          • account_objects
          • account_offers
          • account_tx
          • gateway_balances
          • noripple_check
        • Ledger 메소드
          • ledger
          • ledger_closed
          • ledger_current
          • ledger_data
          • ledger_entry
        • 트랜잭션 메소드
          • submit
          • submit_multisigned
          • transaction_entry
          • tx
          • tx_history
        • 경로와 오더북 메소드
          • book_offers
          • deposit_authorized
          • nft_buy_offers
          • nft_sell_offers
          • path_find
          • ripple_path_find
        • 결제 채널 메소드
          • channel_authorize
          • channel_verify
        • 구독 메소드
          • 구독
          • 구독 취소
        • Server Info 메소드
          • fee
          • manifest
          • server_info (rippled)
          • server_state
        • 클리오 서버
          • server_info
          • ledger
          • nft_history
          • nft_info
        • 유틸리티 메소드
          • json
          • ping
          • random
      • 관리자 API 메소드
        • 키 생성 방법
          • validation_create
          • wallet_propose
        • 로깅 및 데이터 관리 메소드
          • can_delete
          • crawl_shards
          • download_shard
          • ledger_cleaner
          • ledger_request
          • log_level
          • logrotate
          • node_to_shard
        • 서버 컨트롤 메소드
          • ledger_accept
          • stop
          • validation_seed
        • 서명 메소드
          • sign
          • sign_for
        • 피어 관리 메소드
          • connect
          • peer_reservations_add
          • peer_reservations_del
          • peer_reservations_list
          • peers
        • 상태 및 디버깅 메소드
          • consensus_info
          • feature
          • fetch_info
          • get_counts
          • print
          • validator_info
          • validators
        • rippled 커맨드라인 사용 참조
        • 피어 포트 메소드
          • 상태 확인
          • 피어 크롤러
          • 유효성 검증인 목록 메소드
    • xrp-ledger.toml File
  • Infrastructure
    • 커맨드 라인 사용법(Commandline Usage)
    • Install rippled
      • System Requirements
      • Install on CentOS/RedHat with yum
      • Install on Ubuntu or Debian Linux
      • Update Automatically on Linux
      • Update Manually on CentOS/Red Hat
      • Update Manually on Ubuntu or Debian
      • Build and Run rippled in Reporting Mode
      • Capacity Planning
    • Configure rippled
      • Server Modes
        • Run rippled as a Validator
        • Run rippled as a Stock Server
      • Data Retention
        • Configure Full History
        • 온라인 삭제(Online Deletion)
        • Configure Online Deletion
        • Configure Advisory Deletion
        • 히스토리 샤딩(History Sharding)
        • Configure History Sharding
      • Configure Amendment Voting
      • Test Amendments
      • Configure StatsD
      • Connect Your rippled to a Parallel Network
      • Configure gRPC
      • Enable Public Signing
    • Peering
      • Cluster rippled Servers
      • Configure a Private Server
      • Configure the Peer Crawler
      • Enable Link Compression
      • Forward Ports for Peering
      • Manually Connect to a Specific Peer
      • Set Maximum Number of Peers
      • Use a Peer Reservation
    • Testing and Auditing
      • Start a New Genesis Ledger in Stand-Alone Mode
      • Load a Saved Ledger in Stand-Alone Mode
      • Advance the Ledger in Stand-Alone Mode
    • Troubleshooting
      • Diagnosing Problems with rippled
      • Health Check Interventions
      • Understanding Log Messages
      • rippled Server Doesn't Sync
      • rippled Server is Amendment Blocked
      • rippled Server Won't Start
    • Install Clio on Ubuntu Linux
    • Run a Private Network with Docker
Powered by GitBook
On this page
  • 요구 조건(Prerequisites)
  • 예제 코드(Example Code)
  • 단계(Steps)
  • 1. 자격 증명 받기(Get Credentials)
  • 2. 네트워크에 연결(Connect to the Network)
  • 3. 발급자 설정 구성하기(Configure Issuer Settings)
  • 4. 유효성 검사 대기(Wait for Validation)
  • 5. 핫 주소 설정 구성(Configure Hot Address Settings)
  • 6. 유효성 검사 대기 (Wait for Validation)
  • 7. 핫 주소에서 콜드 주소로 신뢰선 생성(Create Trust Line from Hot to Cold Address)
  • 8. 유효성 검사 대기(Wait for Validation)
  • 9. 토큰 전송(Send Token)
  • 10. 유효성 검사 대기(Wait for Validation)
  • 11. 토큰 잔액 확인(Confirm Token Balances)
  • 다음 단계(Next Steps)
  • 각주(Footnotes)
  1. Tutorials
  2. Tasks
  3. 토큰 사용(Use Tokens)

대체가능한 토큰 발행(Issue a Fungible Token)

Previous토큰 사용(Use Tokens)Next탈중앙화 거래소에서 거래(Trade in the Decentralized Exchange)

Last updated 1 year ago

누구나 비공식적인 "IOUs"부터 법정화폐 기반 스테이블코인, 순수 디지털 대체 가능 토큰 및 반대체 가능 토큰 등 다양한 유형의 토큰을 XRP Ledger에서 발행할 수 있습니다. 이 튜토리얼에서는 원장에 토큰을 생성하는 기술적 단계를 보여드립니다. XRP Ledger 토큰의 작동 방식에 대한 자세한 내용은 를, 스테이블코인 발행과 관련된 비즈니스 의사 결정에 대한 자세한 내용은 를 참조하세요.

요구 조건(Prerequisites)

  • 각각 주소, 비밀 키, 약간의 XRP가 예치 되어 있는 2개의 XRP Ledger 계정이 필요합니다. 이 튜토리얼에서는 필요에 따라 새 테스트 자격 증명을 생성할 수 있습니다.

    • 각 주소에는 신뢰선에 대한 추가 준비금을 포함해 준비금 요건을 충족할 수 있는 충분한 XRP가 필요합니다.

  • XRP 원장 네트워크에 연결해야 합니다. 이 튜토리얼에 나와 있는 것처럼 공용 서버를 사용해 테스트할 수 있습니다.

  • 선호하는 클라이언트 라이브러리에 대한 시작하기 지침을 숙지하고 있어야 합니다. 이 페이지에서는 다음에 대한 예제를 제공합니다:

    • 를 사용한 JavaScript . 설정 단계는 JavaScript를 사용하여 시작하기를 참조하세요.

    • 를 사용하는 Python . 설정 단계는 Python을 사용하여 시작하기를 참조하세요.

    • 가 포함된 Java . 설정 단계는 Java를 사용하여 시작하기를 참조하세요.

    • 별도의 설정 없이 브라우저에서 대화형 단계를 따라 읽고 사용할 수도 있습니다.

예제 코드(Example Code)

이 튜토리얼의 모든 단계에 대한 전체 샘플 코드는 에 따라 사용할 수 있습니다.

  • 을 참고하세요:

단계(Steps)

1. 자격 증명 받기(Get Credentials)

XRP Ledger에서 거래하려면 주소와 비밀 키, 그리고 약간의 XRP가 필요합니다. 또한 발행한 토큰을 기꺼이 보유할 한 명 이상의 수신자가 필요합니다. 다른 블록체인과 달리 XRP Ledger에서는 원하지 않는 토큰을 강제로 보유하도록 강요할 수 없습니다.

가장 좋은 방법은 "콜드" 주소와 "핫" 주소를 사용하는 것입니다. 콜드 주소는 토큰의 발행자입니다. 핫 주소는 사용자가 관리하는 일반 사용자의 주소와 같습니다. 콜드 주소에서 토큰을 받은 다음 다른 사용자에게 전송할 수 있습니다. 콜드 주소에서 사용자에게 직접 토큰을 보낼 수 있으므로 핫 주소가 반드시 필요한 것은 아니지만, 보안상 좋은 습관입니다. 프로덕션 환경에서는 콜드 주소를 핫 주소보다 교체하기가 훨씬 어렵기 때문에 콜드 주소의 암호화 키를 오프라인 상태로 유지하는 등 각별히 관리해야 합니다.

이 튜토리얼에서는 핫 주소가 콜드 주소에서 발급한 토큰을 받습니다. 다음 인터페이스를 사용하여 두 주소의 키를 얻을 수 있습니다.

Caution:

2. 네트워크에 연결(Connect to the Network)

네트워크에 트랜잭션을 제출하려면 네트워크에 연결되어 있어야 합니다. 다음 코드는 지원되는 클라이언트 라이브러리가 있는 public XRP Ledger 테스트넷 서버에 연결하는 방법을 보여줍니다:

// In browsers, use a <script> tag. In Node.js, uncomment the following line:
// const xrpl = require('xrpl')

// Wrap code in an async function so we can use await
async function main() {

  // Define the network client
  const client = new xrpl.Client("wss://s.altnet.rippletest.net:51233")
  await client.connect()

  // ... custom code goes here

  // Disconnect when done (If you omit this, Node.js won't end the process)
  client.disconnect()
}

main()
# Connect ----------------------------------------------------------------------
import xrpl
testnet_url = "https://s.altnet.rippletest.net:51234"
client = xrpl.clients.JsonRpcClient(testnet_url)
// Construct a network client ----------------------------------------------
    HttpUrl rippledUrl = HttpUrl
      .get("https://s.altnet.rippletest.net:51234/");
    XrplClient xrplClient = new XrplClient(rippledUrl);
    // Get the current network fee
    FeeResult feeResult = xrplClient.fee();Field	Value
TransactionType	"TrustSet"
Account	The hot address. (More generally, this is the account that wants to receive the token.)
LimitAmount	An object specifying how much, of which token, from which issuer, you are willing to hold.
LimitAmount.currency	The currency code of the token.
LimitAmount.issuer	The cold address.
LimitAmount.value	The maximum amount of the token you are willing to hold.

Note:

이 튜토리얼의 JavaScript 코드 샘플은 async/await 패턴을 사용합니다. await은 비동기 함수 내에서 사용해야 하므로, 나머지 코드 샘플은 여기서 시작한 main() 함수 내에서 계속 진행되도록 작성되었습니다. 원하는 경우 async/await 대신 Promise 메소드 .then() 및 .catch()를 사용할 수도 있습니다.

이 튜토리얼에서는 다음 버튼을 클릭하여 연결합니다:

3. 발급자 설정 구성하기(Configure Issuer Settings)

먼저, 콜드 주소(토큰 발급자가 될)에 대한 설정을 구성합니다. 다음과 같은 예외를 제외하고 대부분의 설정은 나중에 재구성할 수 있습니다:

콜드 주소(발급자)에 대해 선택적으로 구성할 수 있는 기타 설정:

설정
권장값
요약약

활성화 또는 비활성화

외부 시스템으로 토큰 출금을 처리하는 경우 활성화합니다. (예: 토큰이 스테이블코인인 경우).

Disallow XRP

활성화 또는 비활성화

이 주소가 XRP 결제를 처리하지 않는 경우 활성화합니다.

0–1%

사용자가 서로 토큰을 보낼 때 일정 비율의 수수료를 부과합니다.

5

탈중앙화 거래소에서 토큰의 환율 소수점 이하 자릿수를 제한합니다. 틱 크기가 5~6이면 기본값인 15에 비해 거의 동일한 오퍼의 이탈이 줄어들고 가격 검색 속도가 빨라집니다.

(자신의 도메인 이름)

계정 소유권을 확인할 수 있도록 소유한 도메인으로 설정합니다. 이렇게 하면 혼동이나 사칭 시도를 줄일 수 있습니다.

이러한 설정은 나중에 변경할 수도 있습니다.

Note:

많은 발행 설정은 통화 코드에 관계없이 주소에서 발행한 모든 토큰에 동일하게 적용됩니다. XRP Ledger에서 서로 다른 설정으로 여러 유형의 토큰을 발행하려면 각 토큰을 발행할 때마다 다른 주소를 사용해야 합니다.

// Configure issuer (cold address) settings ----------------------------------
  const cold_settings_tx = {
    "TransactionType": "AccountSet",
    "Account": cold_wallet.address,
    "TransferRate": 0,
    "TickSize": 5,
    "Domain": "6578616D706C652E636F6D", // "example.com"
    "SetFlag": xrpl.AccountSetAsfFlags.asfDefaultRipple,
    // Using tf flags, we can enable more flags in one transaction
    "Flags": (xrpl.AccountSetTfFlags.tfDisallowXRP |
             xrpl.AccountSetTfFlags.tfRequireDestTag)
  }

  const cst_prepared = await client.autofill(cold_settings_tx)
  const cst_signed = cold_wallet.sign(cst_prepared)
  console.log("Sending cold address AccountSet transaction...")
  const cst_result = await client.submitAndWait(cst_signed.tx_blob)
  if (cst_result.result.meta.TransactionResult == "tesSUCCESS") {
    console.log(`Transaction succeeded: https://testnet.xrpl.org/transactions/${cst_signed.hash}`)
  } else {
    throw `Error sending transaction: ${cst_result}`
  }
# Configure issuer (cold address) settings -------------------------------------
cold_settings_tx = xrpl.models.transactions.AccountSet(
    account=cold_wallet.address,
    transfer_rate=0,
    tick_size=5,
    domain=bytes.hex("example.com".encode("ASCII")),
    set_flag=xrpl.models.transactions.AccountSetAsfFlag.ASF_DEFAULT_RIPPLE,
)

print("Sending cold address AccountSet transaction...")
response = xrpl.transaction.submit_and_wait(cold_settings_tx, client, cold_wallet)
print(response)
// Configure issuer settings -----------------------------------------------
    UnsignedInteger coldWalletSequence = xrplClient.accountInfo(
      AccountInfoRequestParams.builder()
        .ledgerSpecifier(LedgerSpecifier.CURRENT)
        .account(coldWalletKeyPair.publicKey().deriveAddress())
        .build()
    ).accountData().sequence();

    AccountSet setDefaultRipple = AccountSet.builder()
      .account(coldWalletKeyPair.publicKey().deriveAddress())
      .fee(feeResult.drops().minimumFee())
      .sequence(coldWalletSequence)
      .signingPublicKey(coldWalletKeyPair.publicKey())
      .setFlag(AccountSet.AccountSetFlag.DEFAULT_RIPPLE)
      .lastLedgerSequence(computeLastLedgerSequence(xrplClient))
      .build();

    SignatureService<PrivateKey> signatureService = new BcSignatureService();
    SingleSignedTransaction<AccountSet> signedAccountSet = signatureService.sign(
      coldWalletKeyPair.privateKey(), setDefaultRipple
    );

    submitAndWaitForValidation(signedAccountSet, xrplClient);

4. 유효성 검사 대기(Wait for Validation)

대부분의 트랜잭션은 제출된 후 다음 ledger 버전으로 승인되므로, 트랜잭션 결과가 최종 확정되기까지 4~7초가 소요될 수 있습니다. 이전 트랜잭션이 완전히 검증될 때까지 기다렸다가 이후 단계로 진행해야 순서에 맞지 않게 실행되어 예기치 않은 실패를 방지할 수 있습니다. 자세한 내용은 안정적인 트랜잭션 제출을 참조하세요.

이 튜토리얼의 코드 샘플은 트랜잭션을 제출할 때 유효성 검사를 기다리는 도우미 함수를 사용합니다:

Tip:

기술적으로 핫 주소는 발급자 주소 구성과 병행하여 구성할 수 있습니다. 간단하게 설명하기 위해 이 튜토리얼에서는 각 트랜잭션을 한 번에 하나씩 기다립니다.

5. 핫 주소 설정 구성(Configure Hot Address Settings)

핫 주소는 기본값에서 설정을 반드시 변경해야 하는 것은 아니지만, 다음 사항을 모범 사례로 권장합니다:

설정
권장값
요약

비활성화

이 설정을 비활성화합니다. (기본값입니다.)

활성화

이 설정을 활성화하고 핫 주소에 대한 신뢰선을 승인하지 않으면 실수로 잘못된 주소에서 토큰을 발행하는 것을 방지할 수 있습니다. (선택 사항이지만 권장합니다.)

활성화 또는 비활성화

외부 시스템으로 토큰 인출을 처리하는 경우 활성화합니다. (예: 토큰이 스테이블코인 경우).

Disallow XRP

활성화 또는 비활성화

이 주소가 XRP 결제를 처리하지 않는 경우 활성화합니다.

(도메인 이름)

계정 소유권을 확인할 수 있도록 소유하고 있는 도메인으로 설정합니다. 이렇게 하면 혼동이나 사칭 시도를 줄일 수 있습니다.

다음 코드 샘플은 권장 핫 주소 설정을 활성화하기 위해 AccountSet 트랜잭션을 보내는 방법을 보여줍니다:

// Configure hot address settings --------------------------------------------

  const hot_settings_tx = {
    "TransactionType": "AccountSet",
    "Account": hot_wallet.address,
    "Domain": "6578616D706C652E636F6D", // "example.com"
    // enable Require Auth so we can't use trust lines that users
    // make to the hot address, even by accident:
    "SetFlag": xrpl.AccountSetAsfFlags.asfRequireAuth,
    "Flags": (xrpl.AccountSetTfFlags.tfDisallowXRP |
              xrpl.AccountSetTfFlags.tfRequireDestTag)
  }

  const hst_prepared = await client.autofill(hot_settings_tx)
  const hst_signed = hot_wallet.sign(hst_prepared)
  console.log("Sending hot address AccountSet transaction...")
  const hst_result = await client.submitAndWait(hst_signed.tx_blob)
  if (hst_result.result.meta.TransactionResult == "tesSUCCESS") {
    console.log(`Transaction succeeded: https://testnet.xrpl.org/transactions/${hst_signed.hash}`)
  } else {
    throw `Error sending transaction: ${hst_result.result.meta.TransactionResult}`
  }
# Configure hot address settings -----------------------------------------------
hot_settings_tx = xrpl.models.transactions.AccountSet(
    account=hot_wallet.address,
    set_flag=xrpl.models.transactions.AccountSetAsfFlag.ASF_REQUIRE_AUTH,
)

print("Sending hot address AccountSet transaction...")
response = xrpl.transaction.submit_and_wait(hot_settings_tx, client, hot_wallet)
print(response)
// Configure hot address settings ------------------------------------------
    UnsignedInteger hotWalletSequence = xrplClient.accountInfo(
      AccountInfoRequestParams.builder()
        .ledgerSpecifier(LedgerSpecifier.CURRENT)
        .account(hotWalletKeyPair.publicKey().deriveAddress())
        .build()
    ).accountData().sequence();

    AccountSet setRequireAuth = AccountSet.builder()
      .account(hotWalletKeyPair.publicKey().deriveAddress())
      .fee(feeResult.drops().minimumFee())
      .sequence(hotWalletSequence)
      .signingPublicKey(hotWalletKeyPair.publicKey())
      .setFlag(AccountSet.AccountSetFlag.REQUIRE_AUTH)
      .lastLedgerSequence(computeLastLedgerSequence(xrplClient))
      .build();

    SingleSignedTransaction<AccountSet> signedSetRequireAuth = signatureService.sign(
      hotWalletKeyPair.privateKey(), setRequireAuth
    );
    submitAndWaitForValidation(signedSetRequireAuth, xrplClient);

6. 유효성 검사 대기 (Wait for Validation)

이전과 마찬가지로 합의를 통해 이전 트랜잭션이 검증될 때까지 기다린 후 계속 진행합니다.

7. 핫 주소에서 콜드 주소로 신뢰선 생성(Create Trust Line from Hot to Cold Address)

토큰을 받으려면 먼저 토큰 발급자에 대한 신뢰선을 만들어야 합니다. 이 트랜잭션 라인은 USD 또는 FOO와 같이 발행하려는 토큰의 통화 코드에 따라 다릅니다. 원하는 통화 코드는 무엇이든 선택할 수 있으며, 각 발행자의 토큰은 XRP Ledger 프로토콜에서 별도의 토큰으로 취급됩니다. 그러나 사용자가 리플 설정을 활성화하면 동일한 통화 코드를 가진 토큰의 잔액이 다른 발행자 간에 리플될 수 있습니다.

Tip:

신뢰선에는 받는 사람이 보유할 수 있는 토큰의 양에 대한 '한도'가 있으며, 다른 사람은 지정된 한도보다 더 많은 토큰을 보낼 수 없습니다. 커뮤니티 크레딧 시스템의 경우, 해당 사람을 얼마나 신뢰하는지에 따라 개인별 한도를 구성할 수 있습니다. 다른 유형과 용도의 토큰의 경우 일반적으로 한도를 매우 큰 수로 설정해도 괜찮습니다.

필드
값값

TransactionType

"TrustSet"

Account

계정 핫 주소입니다. (일반적으로 토큰을 받으려는 계정입니다.)

LimitAmount

어느 발행자의 토큰을 얼마만큼 보유할 것인지 지정하는 객체입니다.

LimitAmount.currency

토큰의 통화 코드입니다.

LimitAmount.issuer

콜드 주소입니다.

LimitAmount.value

보유하고자 하는 토큰의 최대 금액입니다.

// Create trust line from hot to cold address --------------------------------
  const currency_code = "FOO"
  const trust_set_tx = {
    "TransactionType": "TrustSet",
    "Account": hot_wallet.address,
    "LimitAmount": {
      "currency": currency_code,
      "issuer": cold_wallet.address,
      "value": "10000000000" // Large limit, arbitrarily chosen
    }
  }

  const ts_prepared = await client.autofill(trust_set_tx)
  const ts_signed = hot_wallet.sign(ts_prepared)
  console.log("Creating trust line from hot address to issuer...")
  const ts_result = await client.submitAndWait(ts_signed.tx_blob)
  if (ts_result.result.meta.TransactionResult == "tesSUCCESS") {
    console.log(`Transaction succeeded: https://testnet.xrpl.org/transactions/${ts_signed.hash}`)
  } else {
    throw `Error sending transaction: ${ts_result.result.meta.TransactionResult}`
  }
# Create trust line from hot to cold address -----------------------------------
currency_code = "FOO"
trust_set_tx = xrpl.models.transactions.TrustSet(
    account=hot_wallet.address,
    limit_amount=xrpl.models.amounts.issued_currency_amount.IssuedCurrencyAmount(
        currency=currency_code,
        issuer=cold_wallet.address,
        value="10000000000", # Large limit, arbitrarily chosen
    )
)

print("Creating trust line from hot address to issuer...")
response = xrpl.transaction.submit_and_wait(trust_set_tx, client, hot_wallet)
print(response)
// Create trust line -------------------------------------------------------
    String currencyCode = "FOO";
    ImmutableTrustSet trustSet = TrustSet.builder()
      .account(hotWalletKeyPair.publicKey().deriveAddress())
      .fee(feeResult.drops().openLedgerFee())
      .sequence(hotWalletSequence.plus(UnsignedInteger.ONE))
      .limitAmount(IssuedCurrencyAmount.builder()
        .currency(currencyCode)
        .issuer(coldWalletKeyPair.publicKey().deriveAddress())
        .value("10000000000")
        .build())
      .signingPublicKey(hotWalletKeyPair.publicKey())
      .build();

    SingleSignedTransaction<TrustSet> signedTrustSet = signatureService.sign(
      hotWalletKeyPair.privateKey(), trustSet
    );

    submitAndWaitForValidation(signedTrustSet, xrplClient);

Note:

인증된 신뢰선을 사용하는 경우 이 단계 다음에 추가 단계가 있는데, 바로 콜드 주소가 핫 주소의 신뢰선을 승인해야 한다는 것입니다. 이 방법에 대한 자세한 내용은 인증 신뢰선 승인하기를 참조하세요.

8. 유효성 검사 대기(Wait for Validation)

이전과 마찬가지로 합의 과정을 통해 이전 트랜잭션이 검증될 때까지 기다렸다가 계속 진행합니다.

9. 토큰 전송(Send Token)

이제 콜드 주소에서 핫 주소로 결제 트랜잭션을 전송하여 토큰을 생성할 수 있습니다. 이 트랜잭션에는 다음과 같은 속성이 있어야 합니다(점 표기법은 중첩된 필드를 나타냄):

필드
값

TransactionType

"Payment"

Account

계정 토큰을 발급하는 콜드 주소입니다.

Amount

금액 생성할 토큰의 양을 지정하는 토큰 금액입니다.

Amount.currency

토큰의 화폐 코드입니다.

Amount.value

발행할 토큰의 십진수 금액(문자열)입니다.

Amount.issuer

발급자 토큰을 발급하는 콜드 주소입니다.

Destination

대상 토큰을 받는 핫 주소(또는 토큰을 받는 다른 계정)입니다.

Paths

Paths토큰을 발급할 때는 이 필드를 생략합니다.

SendMax

SendMax 토큰을 발행할 때는 이 필드를 생략합니다.

DestinationTag

// Send token ----------------------------------------------------------------
  const issue_quantity = "3840"
  const send_token_tx = {
    "TransactionType": "Payment",
    "Account": cold_wallet.address,
    "Amount": {
      "currency": currency_code,
      "value": issue_quantity,
      "issuer": cold_wallet.address
    },
    "Destination": hot_wallet.address,
    "DestinationTag": 1 // Needed since we enabled Require Destination Tags
                        // on the hot account earlier.
  }

  const pay_prepared = await client.autofill(send_token_tx)
  const pay_signed = cold_wallet.sign(pay_prepared)
  console.log(`Sending ${issue_quantity} ${currency_code} to ${hot_wallet.address}...`)
  const pay_result = await client.submitAndWait(pay_signed.tx_blob)
  if (pay_result.result.meta.TransactionResult == "tesSUCCESS") {
    console.log(`Transaction succeeded: https://testnet.xrpl.org/transactions/${pay_signed.hash}`)
  } else {
    throw `Error sending transaction: ${pay_result.result.meta.TransactionResult}`
  }
# Send token -------------------------------------------------------------------
issue_quantity = "3840"
send_token_tx = xrpl.models.transactions.Payment(
    account=cold_wallet.address,
    destination=hot_wallet.address,
    amount=xrpl.models.amounts.issued_currency_amount.IssuedCurrencyAmount(
        currency=currency_code,
        issuer=cold_wallet.address,
        value=issue_quantity
    )
)

print(f"Sending {issue_quantity} {currency_code} to {hot_wallet.address}...")
response = xrpl.transaction.submit_and_wait(send_token_tx, client, cold_wallet)
print(response)
// Send token --------------------------------------------------------------
    Payment payment = Payment.builder()
      .account(coldWalletKeyPair.publicKey().deriveAddress())
      .fee(feeResult.drops().openLedgerFee())
      .sequence(coldWalletSequence.plus(UnsignedInteger.ONE))
      .destination(hotWalletKeyPair.publicKey().deriveAddress())
      .amount(IssuedCurrencyAmount.builder()
        .issuer(coldWalletKeyPair.publicKey().deriveAddress())
        .currency(currencyCode)
        .value("3840")
        .build())
      .signingPublicKey(coldWalletKeyPair.publicKey())
      .build();

    SingleSignedTransaction<Payment> signedPayment = signatureService.sign(
      coldWalletKeyPair.privateKey(), payment
    );

    submitAndWaitForValidation(signedPayment, xrplClient);

10. 유효성 검사 대기(Wait for Validation)

이전과 마찬가지로 합의 과정을 통해 이전 트랜잭션이 검증될 때까지 기다렸다가 계속 진행합니다.

11. 토큰 잔액 확인(Confirm Token Balances)

토큰 발행자 또는 핫 주소의 관점에서 토큰의 잔액을 확인할 수 있습니다. XRP Ledger에서 발행된 토큰의 잔액은 항상 0이 되며, 발행자 관점에서는 음수이고 보유자 관점에서는 양수입니다.

Tip:

XRP Ledger은 완전히 공개되어 있으므로 암호화 키가 없어도 언제든지 모든 계정의 잔액을 확인할 수 있습니다.

다음 코드 샘플은 두 가지 방법을 모두 사용하는 방법을 보여줍니다:

// Check balances ------------------------------------------------------------
  console.log("Getting hot address balances...")
  const hot_balances = await client.request({
    command: "account_lines",
    account: hot_wallet.address,
    ledger_index: "validated"
  })
  console.log(hot_balances.result)

  console.log("Getting cold address balances...")
  const cold_balances = await client.request({
    command: "gateway_balances",
    account: cold_wallet.address,
    ledger_index: "validated",
    hotwallet: [hot_wallet.address]
  })
  console.log(JSON.stringify(cold_balances.result, null, 2))

  client.disconnect()
}
# Check balances ---------------------------------------------------------------
print("Getting hot address balances...")
response = client.request(xrpl.models.requests.AccountLines(
    account=hot_wallet.address,
    ledger_index="validated",
))
print(response)

print("Getting cold address balances...")
response = client.request(xrpl.models.requests.GatewayBalances(
    account=cold_wallet.address,
    ledger_index="validated",
    hotwallet=[hot_wallet.address]
))
print(response)
// Check balances ----------------------------------------------------------
    List<TrustLine> lines = xrplClient.accountLines(
      AccountLinesRequestParams.builder()
        .account(hotWalletKeyPair.publicKey().deriveAddress())
        .ledgerSpecifier(LedgerSpecifier.VALIDATED)
        .build()
    ).lines();
    System.out.println("Hot wallet TrustLines: " + lines);
  }

다음 단계(Next Steps)

이제 토큰을 만들었으므로, 토큰이 XRP Ledger의 기능에 어떻게 적용되는지 살펴볼 수 있습니다:

  • 핫 주소에서 다른 사용자에게 토큰 보내기.

  • 탈중앙화 거래소에서 토큰을 거래합니다.

  • 토큰의 수신 결제를 모니터링합니다.

각주(Footnotes)

리플은 테스트 목적으로만 을 제공하며, 때때로 이러한 테스트 네트워크의 상태를 모든 잔액과 함께 초기화하기도 합니다. 예방책으로 테스트넷/데브넷과 메인넷에서 동일한 주소를 사용하지 마시기 바랍니다.

프로덕션용 소프트웨어를 구축하는 경우()에는 기존 계정을 사용하고 보안 서명 구성()을 사용하여 키를 관리해야 합니다.

기본 Ripple(): 이 설정은 사용자가 서로 토큰을 보낼 수 있도록 하기 위해 필요합니다. 신뢰선을 설정하거나 토큰을 발급하기 전에 이 설정을 활성화하는 것이 가장 좋습니다.

승인된 신뢰선(): (선택 사항) 이 설정('인증 필요'라고도 함)은 명시적으로 승인한 계정만 토큰을 보유하도록 제한합니다. 이미 토큰에 대한 인증번호나 오퍼가 있는 경우에는 이 설정을 사용할 수 없습니다. 참고: 승인된 신뢰선을을 사용하려면 이 튜토리얼에 표시되지 않은 추가 단계를 수행해야 합니다.

다음 코드 샘플은 권장 콜드 주소 설정을 활성화하기 위해 계정 세트 트랜잭션()을 전송하는 방법을 보여줍니다:

JavaScript: 제출 및 확인 코드 샘플()에 정의된 submit_and_verify() 함수.

Python: xrpl-py 라이브러리의 submit_and_wait() 메소드().

Java: 의 submitAndWaitForValidation() 메소드.

핫 주소는 발행자로부터 토큰을 받기 전에 이와 같은 트러스트 라인이 필요합니다. 마찬가지로 토큰을 보유하려는 각 사용자도 trust line¹을 생성해야 합니다. 각 신뢰선은 핫 주소의 을 증가시키므로, 증가된 요구량을 지불할 수 있는 충분한 양의 XRP를 보유해야 합니다. 신뢰선을 제거하면 reserve requirement은 다시 낮아집니다.

신뢰선을 만들려면 핫 주소에서 다음 필드가 포함된 을 전송합니다:

다음 코드 샘플은 핫 주소에서 10억 FOO의 한도로 발행 주소를 신뢰하여 을 보내는 방법을 보여줍니다:

데스티네이 태그 0에서 232-1 사이의 정수입니다. 핫 주소에서 를 사용하도록 설정한 경우 여기에 무언가를 지정해야 합니다.

다른 모든 필수 필드에는 자동 입력된 값()을 사용할 수 있습니다.

다음 코드 샘플은 콜드 주소에서 핫 주소로 88 FOO를 발행하는 결제 트랜잭션()을 전송하는 방법을 보여줍니다:

를 사용하여 보유자 관점에서 잔액을 조회할 수 있습니다. 여기에는 각 신뢰선이 한도, 잔액, 설정과 함께 나열됩니다.

토큰 발행자의 관점에서 잔액을 조회하려면 메서드를 사용합니다. 이 메서드는 특정 주소에서 발행한 모든 토큰의 합계를 제공합니다.

을 생성하고 토큰 발행자에 대한 도메인 확인을 설정합니다.

XRP Ledger 토큰의 다른 기능()에 대해 알아보세요.

¹ 사용자가 탈중앙화 거래소에서 토큰을 구매하면 명시적으로 신뢰선을 만들지 않고도 토큰을 보유할 수 있습니다. 에서 토큰을 구매하면 됩니다. 이는 누군가 탈중앙화 거래소에서 토큰을 판매하는 경우에만 가능합니다.

Issued Currencies
Stablecoin Issuer
xrpl.js library
xrpl-py library
xrpl4j library
MIT license
Code Samples: Issue a Fungible Token
Generate
Connect
Configure Issuer
Wait (Issuer Setup)
Configure Hot Address
Wait (Hot Address Setup)
Make Trust Line
Wait (TrustSet)
Send Token
Wait (Payment)
Confirm Balances
Testnet and Devnet
building production-ready software
secure signing configuration
Generate
Connect
Configure Issuer
Wait (Issuer Setup)
Configure Hot Address
Wait (Hot Address Setup)
Make Trust Line
Wait (TrustSet)
Send Token
Wait (Payment)
Confirm Balances
Default Ripple
Authorized Trust Lines
AccountSet transaction
submit-and-verify code sample
method of the xrpl-py library
sample Java class
Generate
Connect
Configure Issuer
Wait (Issuer Setup)
Configure Hot Address
Wait (Hot Address Setup)
Make Trust Line
Wait (TrustSet)
Send Token
Wait (Payment)
Confirm Balances
Generate
Connect
Configure Issuer
Wait (Issuer Setup)
Configure Hot Address
Wait (Hot Address Setup)
Make Trust Line
Wait (TrustSet)
Send Token
Wait (Payment)
Confirm Balances
Generate
Connect
Configure Issuer
Wait (Issuer Setup)
Configure Hot Address
Wait (Hot Address Setup)
Make Trust Line
Wait (TrustSet)
Send Token
Wait (Payment)
Confirm Balances
reserve requirement
TrustSet transaction
TrustSet transaction
Generate
Connect
Configure Issuer
Wait (Issuer Setup)
Configure Hot Address
Wait (Hot Address Setup)
Make Trust Line
Wait (TrustSet)
Send Token
Wait (Payment)
Confirm Balances
Generate
Connect
Configure Issuer
Wait (Issuer Setup)
Configure Hot Address
Wait (Hot Address Setup)
Make Trust Line
Wait (TrustSet)
Send Token
Wait (Payment)
Confirm Balances
auto-filled values
Payment transaction
Generate
Connect
Configure Issuer
Wait (Issuer Setup)
Configure Hot Address
Wait (Hot Address Setup)
Make Trust Line
Wait (TrustSet)
Send Token
Wait (Payment)
Confirm Balances
account_lines method
gateway_balances
Generate
Connect
Configure Issuer
Wait (Issuer Setup)
Configure Hot Address
Wait (Hot Address Setup)
Make Trust Line
Wait (TrustSet)
Send Token
Wait (Payment)
Confirm Balances
xrp-ledger.toml file
features of XRP Ledger tokens
탈중앙화 거래소
필요한 신뢰선이 자동으로 생성
Require Destination Tags
Transfer Fee
Tick Size
Domain
Default Ripple
Authorized Trust Lines
Require Destination Tags
Domain
Require Destination Tags