트랜잭션

이 챕터에서는 XRP Ledger의 트랜잭션에 관한 설명과 트랜잭션을 생성하고 제출하는 방법을 소개합니다.

1. 트랜잭션이란?

"트랜잭션"이란 일반적으로 거래나 이동을 의미하는 것으로, 어떤 것을 한 곳에서 다른 곳으로 옮기는 작업을 나타냅니다. 트랜잭션은 물리적 또는 디지털 상품의 교환, 정보의 전송, 또는 금융 거래에 모두 적용될 수 있습니다.

XRP Ledger에서 트랜잭션은 원장의 상태를 바꾸는 유일한 방법입니다. XRP Ledger에서 트랜잭션을 제출하면, 이는 대기열에 들어가며, 다음 레저에서 처리될 차례를 기다립니다. 트랜잭션이 성공적으로 처리되면, 이는 더 이상 변경될 수 없는 최종 트랜잭션으로 간주되며, 관련된 계정 상태(예: 잔고)는 이 트랜잭션에 따라 업데이트됩니다. 일부 원장 규칙은 또한 pseudo-트랜잭션을 생성하는데, 이는 서명되거나 제출되지 않지만 여전히 합의를 통해 수락되어야 합니다.

트랜잭션은 돈을 보내는 것 이상의 역할을 할 수 있습니다. 여러 가지 결제 유형을 지원하는 것 외에도 XRP Ledger의 트랜잭션은 암호화키를 바꾸는 것, 기타 설정을 관리하는 것, 그리고 XRP 원장의 분산형 거래소에서 거래하는 것 등을 위해 사용됩니다.

트랜잭션 비용 (수수료)

XRP Ledger에서 트랜잭션을 처리하는데는 어느 정도의 비용이 들며, 이를 "트랜잭션 비용" 또는 "수수료" 라고 합니다.

트랜잭션을 제출할 때, 제출자는 XRP를 지불합니다. 이 수수료는 네트워크 스팸을 방지하는 역할을 하며, 사용된 XRP는 시스템에서 소멸 ("burn")되어서 돌아오지 않습니다. 이렇게 소멸된 XRP는 시장에서 제거되기 때문에, 그 양은 XRP의 전체 공급량을 감소시키는 결과를 가져옵니다.

이 수수료는 네트워크의 부하 상태에 따라 동적으로 조정됩니다. 따라서, 네트워크가 바쁠 때는 더 많은 수수료를 지불하게 됩니다. 그 값은 일반적으로 0.00001 XRP에서 0.0005 XRP 사이입니다.

2. XRP Ledger의 트랜잭션 구조

XRP Ledger의 트랜잭션은 JSON 형식으로 표현됩니다. 트랜잭션은 다음과 같은 필드를 포함합니다:

• 계정 주소: 트랜잭션을 보내는 계정의 주소입니다.

• 트랜잭션 유형: 트랜잭션의 유형을 나타내는 문자열입니다. 예를 들어, Payment는 XRP 또는 사용자 정의 통화를 한 계정에서 다른 계정으로 전송하는 트랜잭션을 나타냅니다.

• 트랜잭션 필드: 트랜잭션 유형에 따라 필요한 필드가 다릅니다. 예를 들어, Payment 트랜잭션에는 Amount 필드가 있습니다. 이 필드는 송금할 금액을 나타냅니다.

• 서명: 트랜잭션은 송신자의 비밀키로 서명되어야 합니다. 이는 트랜잭션의 발송인이 자신의 계정을 제어하고 트랜잭션을 생성했음을 증명합니다.

• 공개 키: 트랜잭션의 서명을 검증하는 데 사용되는 공개 키입니다. 이는 트랜잭션의 유효성을 검사하거나 트랜잭션을 조회할 때 사용됩니다.

• 수수료: 트랜잭션을 제출할 때는 일반적으로 트랜잭션 비용이 부과됩니다. 이 비용은 스팸 트랜잭션을 방지하고, 시스템의 자원을 공정하게 분배하기 위한 것입니다. 트랜잭션 비용은 송신자의 XRP 잔고에서 차감되며, 복구할 수 없습니다.

• 트랜잭션 해시: 트랜잭션은 해시 값으로 식별됩니다. 이는 트랜잭션의 내용을 요약한 값으로, 트랜잭션의 유효성을 검사하거나 트랜잭션을 조회할 때 사용됩니다.

더 자세한 내용은 XRP Ledger 공식 문서를 참고하세요.

3. 트랜잭션의 종류

XRP Ledger에서는 다양한 종류의 트랜잭션이 있습니다. 대표적인 트랜잭션 유형은 다음과 같습니다.

• Payment: XRP 또는 사용자가 정의한 통화를 한 계정에서 다른 계정으로 전송하는 트랜잭션입니다. 이는 XRP Ledger의 가장 기본적인 트랜잭션 유형 중 하나입니다.

• AccountSet: 계정의 설정을 변경하는 트랜잭션입니다. 이 설정에는 전송률, 자체 주소에서 토큰을 수신하는 것을 허용할지 여부, 계정 관련 정보 등이 포함될 수 있습니다.

• OfferCreate: 거래소에서 새로운 주문을 만드는 트랜잭션입니다. 이 주문은 XRP와 사용자 정의 통화 간의 거래를 나타낼 수 있습니다.

• OfferCancel: 거래소에서 기존의 주문을 취소하는 트랜잭션입니다. 이 트랜잭션을 통해 더 이상 원하지 않는 거래를 중지할 수 있습니다.

• EscrowCreate: XRP를 조건부로 잠그는 트랜잭션입니다. 이 조건은 시간이나 암호 해제와 같은 특정 요구사항을 충족하는 것일 수 있습니다.

• EscrowFinish: 잠겨진 XRP의 조건이 충족되면, 이 트랜잭션을 통해 해당 XRP를 해제할 수 있습니다.

• EscrowCancel: 시간이 만료되면, 이 트랜잭션을 사용해 잠겨진 XRP를 취소하고 원래의 송신자에게 돌려줄 수 있습니다.

• CheckCreate: 특정 수신자가 나중에 현금화할 수 있는 '체크'를 만드는 트랜잭션입니다.

• CheckCash: 체크를 현금화하여 해당 체크의 XRP 또는 사용자 정의 통화를 받는 트랜잭션입니다.

• CheckCancel: 아직 현금화되지 않은 체크를 취소하는 트랜잭션입니다.

이외에도 다양한 트랜잭션 유형이 있습니다. 자세한 내용은 XRP Ledger 공식 문서를 참고하세요.

4. 트랜잭션 Lifecycle

모든 트랜잭션들은 다음의 생명주기를 가집니다. 트랜잭션의 생명주기는 트랜잭션 생성부터 최종적으로 레저에 포함될 때까지의 과정을 말합니다. 각 단계는 다음과 같습니다:

1. 트랜잭션 생성

   트랜잭션 객체는 필요한 필드(트랜잭션 유형, 계정, 수신자, 금액 등)를 포함하여 생성됩니다. 이 단계에서는 필요한 모든 데이터를 수집하고 유효성을 검사합니다. xrpl.models.transactions에서 올바른 트랜잭션 유형을 선택하고, 필요한 필드를 채워넣어 트랜잭션을 생성할 수 있습니다. 필요한 필드는 직접 채우거나 xrpl.transaction.autofill 함수를 사용하여 자동으로 채워넣을 수 있습니다.

2. 트랜잭션 서명

   트랜잭션은 송신자의 비밀키로 서명되어야 합니다. 이는 트랜잭션의 발송인이 자신의 계정을 제어하고 트랜잭션을 생성했음을 증명합니다.

   트랜잭션 객체의 sign 메서드를 사용하여 트랜잭션을 서명할 수 있습니다.

3. 트랜잭션 제출

   서명된 트랜잭션은 XRP Ledger에 제출되어 다음 유효성 검사 단계로 넘어갑니다. 제출된 트랜잭션은 대기열에 들어가며, 다음 레저에서 처리될 차례를 기다립니다.

   트랜잭션 객체의 submit 메서드를 사용하여 트랜잭션을 제출할 수 있습니다.

4. 트랜잭션 검증

   대기열에 들어간 트랜잭션은 검증자 노드들 (validator nodes)에 의해 리플의 합의 알고리즘인 (RPCA)를 거쳐 레저의 새 버전을 만드는 검증자들은 제출된 트랜잭션을 검증하고 처리합니다. 트랜잭션이 유효하다면 (예: 충분한 잔고, 올바른 서명 등), 이는 새 레저에 포함됩니다.

   트랜잭션이 레저에 포함되면, 이는 더 이상 변경될 수 없습니다.

5. 최종 트랜잭션

   트랜잭션이 레저에 포함되면, 이는 완료된 상태로 간주되며, 관련된 계정 상태(예: 잔고)는 이 트랜잭션에 따라 업데이트됩니다.

5. Secure Transaction

https://xrpl.org/reliable-transaction-submission.html#reliable-transaction-submission

---

XRP 보내기

직접 실습을 통해 간단한 트랜잭션을 생성하고 제출하는 방법을 배워보도록 하겠습니다.

이 예제는 Payment 트랜잭션을 이용해서 XRP를 보내는 과정을 보여줍니다.

먼저 앞에서 설명한 트랜잭션의 생명주기를 xrpl-py 라이브러리를 이용해 함수로 구현해보면 다음과 같습니다.

def submit_transaction(
    client: JsonRpcClient,
    wallet: Wallet,
    transaction: Transaction,
    check_fee: bool = True,
) -> dict:
    """
    트랜잭션을 제출하고 그 결과를 반환합니다.

    Args:
        client (JsonRpcClient): XRPL과 통신하기 위한 클라이언트 객체 입니다.
        wallet (Wallet): 트랜잭션을 제출하는 계정의 지갑 객체입니다.
        transaction (Transaction): 제출할 트랜잭션입니다.
        check_fee (bool, optional): 수수료를 확인할지 여부입니다. 기본값으로 True를 사용합니다.

    Returns:
        dict: 트랜잭션의 결과입니다.

    Raises:
        XRPLReliableSubmissionException: 트랜잭션 제출이 실패하면 발생합니다.
    """
    # Autofill and sign transaction
    signed_tx = autofill_and_sign(
        transaction=transaction,
        client=client,
        wallet=wallet,
        check_fee=check_fee,
    )

    # Validate transaction
    signed_tx.validate()

    # Send transaction and get response
    response = submit_and_wait(
        transaction=signed_tx, client=client, wallet=wallet
    )

    # Raise exception if transaction failed
    if not response.is_successful():
        raise XRPLReliableSubmissionException(response.result)

    # Return result
    return response.result

이 함수는 클라이언트 객체, 지갑 객체, 트랜잭션 객체를 인자로 받습니다.

트랜잭션의 필드들을 autofill 함수를 이용해 자동으로 채우고, 지갑 객체를 이용해 트랜잭션을 서명합니다.

그 후 직접 트랜잭션이 유효한지 검사하고, submit_and_wait 함수를 이용해 트랜잭션을 제출합니다.

결과를 기다렸다가 트랜잭션이 성공적으로 처리되면 예외를 발생시키고 아니라면 결과를 반환합니다.

트랜잭션 생성

payment_tx = Payment(
    account=wallet.classic_address,
    amount="1000",
    destination="rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe",
    last_ledger_sequence=ledger_sequence + 10,
)

트랜잭션 객체는 클라이언트와 소통하지 않고 로컬에서 필요한 필드를 채우는 것으로 생성됩니다.

Payment 클래스는 Transaction 클래스를 상속받습니다. Transaction 클래스는 트랜잭션의 공통 필드를 포함하며, Payment 클래스는 Transaction 클래스의 필드에 더해 특정한 트랜잭션 유형에 필요한 추가 필드를 포함합니다.

모든 트랜잭션 객체들은 Transaction 클래스를 상속받으며, 트랜잭션 유형에 따라 필요한 추가 필드를 포함합니다.

트랜잭션 자동 채우기와 서명

signed_tx = autofill_and_sign(
    transaction=transaction,
    client=client,
    wallet=wallet,
    check_fee=check_fee,
)

트랜잭션 객체가 생성되면, 이를 자동으로 채우고 서명할 수 있습니다. 이를 위해 autofill_and_sign 함수를 사용합니다. 이 함수는 트랜잭션 객체를 채우고 서명한 후, 채워진 트랜잭션 객체를 반환합니다.

자동 채우기(autofill)은 클라이언트를 통해 네트워크와 소통하여, Fee 값과 sequence값이 사용자에 의해 주어지지 않았다면 올바르게 채웁니다. autofill 함수의 check_fee 매개변수는 True로 설정하면 Fee 값이 네트워크의 예상 Fee 값보다 너무 높으면 예외를 발생시킵니다.

서명(sign)은 로컬에서 사용자의 지갑(private key)을 통해 트랜잭션을 서명합니다. 이 과정에서 SigningPubKey 필드와 TxnSignature 필드가 자동으로 채워집니다. SigningPubKey는 사용자의 공개키이고, TxnSignature는 서명 값입니다. 블록체인 네트워크에서는 이 두 필드를 이용해 서명 값을 공개키로 검증하여 트랜잭션의 유효성을 검증합니다.

트랜잭션 유효성 검사

signed_tx.validate()

트랜잭션의 필수 필드가 모두 채워졌는지, 필드의 값이 유효한지 등을 검사합니다. 이 과정에서 필드의 값이 유효하지 않으면 예외를 발생시킵니다.

트랜잭션 제출

response = submit_and_wait(transaction=signed_tx, client=client)

if not response.is_successful():
    raise XRPLReliableSubmissionException(response.result)

submit_and_wait 함수는 트랜잭션을 제출하고, 트랜잭션이 성공적으로 처리될 때까지 기다립니다. 이 과정에서 트랜잭션은 대기열에 들어가며, 다음 레저에서 처리될 차례를 기다립니다. 트랜잭션이 성공적으로 처리되지 않으면 예외를 발생시킵니다.

트랜잭션 결과

return response.result

{'Account': 'rh215fU5Pk9N4p2zLdDfRFSKniYqP3qxp7',
 'Amount': '1000',
 'Destination': 'rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe',
 'Fee': '10',
 'Flags': 0,
 'LastLedgerSequence': 39630981,
 'Sequence': 39630970,
 'SigningPubKey': 'EDFDBDBD538F1D8DD89A21C91BA824FC9AAA516DAC9BD8144E0E5C0CB3F6FF80AC',
 'TransactionType': 'Payment',
 'TxnSignature': 'B7E679A367C0F89E131CC6E6EB969936B2C69EED5D083E6B11EC7566CE6B7471B1C2BF322100D633C64F53D4F8419F939F3AD50741DF18CF4FC303AE77F3B206',
 'date': 743129490,
 'hash': '99B0DFDD6E2A0CD830919B29DECAD78DA76250ACC94805A6B8C89BA4E57F5D97',
 'inLedger': 39630974,
 'ledger_index': 39630974,
 'meta': {'AffectedNodes': [{'ModifiedNode': {'FinalFields': {'Account': 'rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe',
                                                              'Balance': '87893903718205934',
                                                              'Flags': 0,
                                                              'OwnerCount': 0,
                                                              'Sequence': 6154587},
                                              'LedgerEntryType': 'AccountRoot',
                                              'LedgerIndex': '31CCE9D28412FF973E9AB6D0FA219BACF19687D9A2456A0C2ABC3280E9D47E37',
                                              'PreviousFields': {'Balance': '87893903718204934'},
                                              'PreviousTxnID': '219D7A899BEF52A6C657B1FE3ED6DCAD7EDAF8BC6D1D279E358CDF6BAB5E5BA4',
                                              'PreviousTxnLgrSeq': 39630970}},
                            {'ModifiedNode': {'FinalFields': {'Account': 'rh215fU5Pk9N4p2zLdDfRFSKniYqP3qxp7',
                                                              'Balance': '9999998990',
                                                              'Flags': 0,
                                                              'OwnerCount': 0,
                                                              'Sequence': 39630971},
                                              'LedgerEntryType': 'AccountRoot',
                                              'LedgerIndex': 'EC06857C98943B84709530C08941FA74DAFC92B30B194D8386209B6D48BB7D3D',
                                              'PreviousFields': {'Balance': '10000000000',
                                                                 'Sequence': 39630970},
                                              'PreviousTxnID': '219D7A899BEF52A6C657B1FE3ED6DCAD7EDAF8BC6D1D279E358CDF6BAB5E5BA4',
                                              'PreviousTxnLgrSeq': 39630970}}],
          'TransactionIndex': 1,
          'TransactionResult': 'tesSUCCESS',
          'delivered_amount': '1000'},
 'validated': True}

트랜잭션이 성공적이었다면, 트랜잭션의 결과는 위와 같이 나타납니다.