Working with Klaytn Transaction Types

Klaytn은 다양한 트랜잭션 타입을 지원하며 각 트랜잭션은 서로 다른 필드를 가집니다. 따라서 사용자들은 트랜잭션 타입을 반드시 먼저 이해한 다음 트랜잭션 전송 및 서명 시 올바른 타입을 사용해야 합니다. 관련 API: klay_signTransaction, klay_sendTransaction, klay_signTransactionAsFeePayer, klay_sendTransactionAsFeePayer, personal_signTransaction, personal_sendTransaction.

TxTypeLegacyTransaction

TxTypeLegacyTransaction은 Klaytn에 있는 기존 트랜잭션 타입입니다. 이 트랜잭션 타입은 호환을 위해 존재합니다. 더 자세한 정보는 TxTypeLegacyTransaction을 참고하십시오.

Parameters

NameTypeDescription

from

20-byte DATA

The address from which the transaction is sent.

to

20-byte DATA

(컨트랙트 생성 시 선택사항) 트랜잭션 수신자의 주소입니다.

gas

QUANTITY

(선택사항이며, 기본 설정은 90000입니다.) 트랜잭션 실행을 위해 설정한 가스양의 정숫값입니다. 사용되지 않은 가스는 발신자에게 환불됩니다. 입력한 가스가 트랜잭션을 실행하기에 충분하지 않다면 트랜잭션은 거부됩니다.

gasPrice

QUANTITY

(선택사항이며, 기본 설정은 25000000000 Peb입니다.) 가스 가격의 정숫값입니다. 트랜잭션 수수료는 gas와 gasPrice를 곱한 값입니다.

value

QUANTITY

(optional) Integer of the value sent with this transaction.

data

DATA

배포할 컨트랙트를 컴파일하면 얻는 바이트코드, 또는 컨트랙트를 호출할 때 필요한 함수 지시자(function indicator)와 파라미터 값(parameter values)들입니다.

nonce

QUANTITY

(선택사항) 논스의 정숫값입니다.

Example

// Request
curl -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0", "method":"klay_signTransaction", "params":[{"from":"0x77982323172e5b6182539d3522d5a33a944206d4", "to":"0xcd6bfdb523a4d030890d28bf1eb6ef36307c9aaa", "value":"0x10000", "gas":"0x1000000", "nonce":"0x2", "gasprice":"0x25000000000"}],"id":73}' https://public-en-baobab.klaytn.net

// Result
{
  "jsonrpc":"2.0",
  "id":73,
  "result":{
    "raw":"0xf86c0286025000000000840100000094cd6bfdb523a4d030890d28bf1eb6ef36307c9aaa8301000080820fe8a056d2ddd231c3c111687ab351d339240db18cd721e5aa33c601dd4fc3927fb4d1a03443443392517aa7da082aa0a00b9ee5e3e1ee007d22e57cd9ff55b5ddbf4a64",
    "tx":{
      "nonce":"0x2",
      "gasPrice":"0x5d21dba00",
      "gas":"0x1000000",
      "to":"0xcd6bfdb523a4d030890d28bf1eb6ef36307c9aaa",
      "value":"0x10000",
      "input":"0x",
      "v":"0xfe8",
      "r":"0x56d2ddd231c3c111687ab351d339240db18cd721e5aa33c601dd4fc3927fb4d1",
      "s":"0x3443443392517aa7da082aa0a00b9ee5e3e1ee007d22e57cd9ff55b5ddbf4a64",
      "hash":"0xb53cc9128a19c3916c0de1914725b7337bba84666c2556d8682c72ca34c6874c"
    }
  }
}

TxTypeValueTransfer

TxTypeValueTransfer는 사용자가 KLAY를 전송할 때 사용됩니다. 더 자세한 정보는 TxTypeValueTransfer를 참고하십시오.

Parameters

NameTypeDescription

typeInt

정수

TxTypeValueTransfer를 가리키는 정수값 8입니다.

from

20-byte DATA

The address from which the transaction is sent.

to

20-byte DATA

트랜잭션을 수신할 주소입니다.

gas

QUANTITY

(optional, default: 90000) Integer of the gas provided for the transaction execution. Unused gas will be refunded to the sender. If the specified gas is not enough to execute the transaction, the transaction is reverted.

gasPrice

QUANTITY

(optional, default: 25000000000 Peb) Integer of the gasPrice. The transaction fee is calculated by the multiplication of gas and gasPrice.

nonce

QUANTITY

(optional) Integer of a nonce.

value

QUANTITY

트랜잭션을 통해 전송하고자 하는 송금액의 정숫값입니다.

Example

// Request
curl -H "Content-Type: application/json" --data '{"jsonrpc": "2.0", "method": "klay_signTransaction", "params": [{"typeInt": 8, "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "to": "0x44711E89b0c23845b5B2ed9D3716BA42b8a3e075", "gas": "0x76c0", "gasPrice": "0x5d21dba00", "value": "0xf4"}], "id": 69}' http://127.0.0.1:8551

// Result
{
    "id": 69,
    "jsonrpc": "2.0",
    "result": {
        "raw": "0x08f87f0b8505d21dba008276c09444711e89b0c23845b5b2ed9d3716ba42b8a3e07581f494cd01b2b44584fb143824c1ea0231bebaea826b9df847f845824e44a05ce70c3caa0bd5ab73ef1fc11d3a8d866370b36abb153a1cd9203cd15e1f77fea01e4533af9cd3f6f6a107d76f9599f0811f5bc3c89c10e545420caa5bf99ae974",
        "tx": {
            "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d",
            "gas": "0x76c0",
            "gasPrice": "0x5d21dba00",
            "hash": "0x990dab1df932e32fcf3c03578356eacd52eb5b0e8d384ed029d1d6fa53285599",
            "nonce": "0xb",
            "signatures": [
                {
                    "R": "0x5ce70c3caa0bd5ab73ef1fc11d3a8d866370b36abb153a1cd9203cd15e1f77fe",
                    "S": "0x1e4533af9cd3f6f6a107d76f9599f0811f5bc3c89c10e545420caa5bf99ae974",
                    "V": "0x4e44"
                }
            ],
            "to": "0x44711e89b0c23845b5b2ed9d3716ba42b8a3e075",
            "type": "TxTypeValueTransfer",
            "typeInt": 8,
            "value": "0xf4"
        }
    }
}

TxTypeFeeDelegatedValueTransfer

트랜잭션 수수료 위임 개념을 도입한 TxTypeValueTransfer입니다. 더 자세한 정보는 TxTypeFeeDelegatedValueTransfer를 참고하십시오.

Parameters

NameTypeDescription

typeInt

Integer

TxTypeFeeDelegatedValueTransfer를 가리키는 정수값 9입니다.

from

20-byte DATA

The address from which the transaction is sent.

to

20-byte DATA

The address to which the transaction is directed.

gas

QUANTITY

(optional, default: 90000) Integer of the gas provided for the transaction execution. Unused gas will be refunded to the sender. If the specified gas is not enough to execute the transaction, the transaction is reverted.

gasPrice

QUANTITY

(optional, default: 25000000000 Peb) Integer of the gasPrice. The transaction fee is calculated by the multiplication of gas and gasPrice.

nonce

QUANTITY

(optional) Integer of a nonce.

value

QUANTITY

Integer of the value sent with this transaction.

feePayer

20-byte DATA

트랜잭션 수수료 납부자의 주소입니다.

signatures

DATA

(선택 사항 - 오직 klay_sendTransactionAsFeePayer API에만 적용됨) 서명 객체들이 담긴 배열입니다. A signature object contains three fields (V, R, and S). V contains ECDSA recovery id. R contains ECDSA signature r while S contains ECDSA signature s.

예시 1(klay_signTransaction)

// Request
curl -H "Content-Type: application/json" --data '{"jsonrpc": "2.0", "method": "klay_signTransaction", "params": [{"typeInt": 9, "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "to": "0x44711E89b0c23845b5B2ed9D3716BA42b8a3e075", "gas": "0x76c0", "gasPrice": "0x5d21dba00", "value": "0xf4", "feePayer": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d"}], "id": 59}' http://127.0.0.1:8551

// Result
{
    "id": 59,
    "jsonrpc": "2.0",
    "result": {
        "raw": "0x09f8950b8505d21dba008276c09444711e89b0c23845b5b2ed9d3716ba42b8a3e07581f494cd01b2b44584fb143824c1ea0231bebaea826b9df847f845824e44a0621661c647dd66e9abd8e5188dd9b60bac91bd0e6df4788d4ff34718d004f790a06349719dc6072fec3bf6baae76c4f129cfdf7cefb8a5607ab693928559c1e5bb94cd01b2b44584fb143824c1ea0231bebaea826b9dc0",
        "tx": {
            "feePayer": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d",
            "feePayerSignatures": [],
            "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d",
            "gas": "0x76c0",
            "gasPrice": "0x5d21dba00",
            "hash": "0xed0646d9933e1611ebb7018056fd7ff74c076f7f53bfe1a817d3c677a8978e27",
            "nonce": "0xb",
            "signatures": [
                {
                    "R": "0x621661c647dd66e9abd8e5188dd9b60bac91bd0e6df4788d4ff34718d004f790",
                    "S": "0x6349719dc6072fec3bf6baae76c4f129cfdf7cefb8a5607ab693928559c1e5bb",
                    "V": "0x4e44"
                }
            ],
            "to": "0x44711e89b0c23845b5b2ed9d3716ba42b8a3e075",
            "type": "TxTypeFeeDelegatedValueTransfer",
            "typeInt": 9,
            "value": "0xf4"
        }
    }
}

예시 2(klay_sendTransactionAsFeePayer)

// Request
curl -H "Content-Type: application/json" --data '{"jsonrpc": "2.0", "method": "klay_sendTransactionAsFeePayer", "params": [{"typeInt": 9, "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "nonce": "0x1c", "to": "0x44711E89b0c23845b5B2ed9D3716BA42b8a3e075", "gas": "0x2e6300", "gasPrice": "0x5d21dba00", "value": "0xf4", "feePayer": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "signatures": [{"V": "0x4e43", "R": "0x416a7d1833322359ae7b0f9aad10185f94739a81997af0abd1330ee866564957", "S": "0x1f6bd04c4ebcccced7d2f6b57be088c69070b94ad62898427e906f35b2b48b35"}]}], "id": 69}' http://127.0.0.1:8551

// Result
{
    "id": 69,
    "jsonrpc": "2.0",
    "result": "0xd2bab65e2563fd77d8ee50ac70f6d4aff64456e36d410370a920fa54f1094043"
}

TxTypeFeeDelegatedValueTransferWithRatio

부분 트랜잭션 수수료 위임 개념을 도입한 TxTypeValueTransfer입니다. 더 자세한 정보는 TxTypeFeeDelegatedValueTransferWithRatio를 참고하십시오.

Parameters

NameTypeDescription

typeInt

Integer

TxTypeFeeDelegatedValueTransferWithRatio를 가리키는 정수값 10입니다.

from

20-byte DATA

The address from which the transaction is sent.

to

20-byte DATA

The address to which the transaction is directed.

gas

QUANTITY

(optional, default: 90000) Integer of the gas provided for the transaction execution. Unused gas will be refunded to the sender. If the specified gas is not enough to execute the transaction, the transaction is reverted.

gasPrice

QUANTITY

(선택사항이며, 기본 설정은 25000000000 Peb입니다.) 지불된 가스당 가스 가격의 정숫값입니다.

nonce

QUANTITY

(optional) Integer of a nonce.

value

QUANTITY

Integer of the value sent with this transaction.

feePayer

20-byte DATA

트랜잭션 수수료 납부자의 주소.

feeRatio

QUANTITY

트랜잭션 수수료 납부자의 부담 비율입니다. If it is 30, 30% of the fee will be paid by the fee payer. 70% will be paid by the sender. 수수료 비율의 범위는 1 ~ 99이며, 이 범위를 벗어나면 트랜잭션이 수락되지 않습니다.

signatures

DATA

(optional - only for klay_sendTransactionAsFeePayer API) An array of signature objects. A signature object contains three fields (V, R, and S). V contains ECDSA recovery id. R contains ECDSA signature r while S contains ECDSA signature s.

Example 1 (klay_signTransaction)

// Request
curl -H "Content-Type: application/json" --data '{"jsonrpc": "2.0", "method": "klay_signTransaction", "params": [{"typeInt": 10, "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "to": "0x44711E89b0c23845b5B2ed9D3716BA42b8a3e075", "gas": "0x76c0", "gasPrice": "0x5d21dba00", "value": "0xf4", "feePayer": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "feeRatio": 30}], "id": 42}' http://127.0.0.1:8551

// Result
{
    "id": 42,
    "jsonrpc": "2.0",
    "result": {
        "raw": "0x0af8960b8505d21dba008276c09444711e89b0c23845b5b2ed9d3716ba42b8a3e07581f494cd01b2b44584fb143824c1ea0231bebaea826b9d1ef847f845824e44a0dd413e74782985ca1de84c5cfe76d25ada70d4498e12fb1f52fc543884a4c0c9a029421d970b89bd271f5ecdbb91c9dcac70f556e38dd7516d2d711276ea0d63bc94cd01b2b44584fb143824c1ea0231bebaea826b9dc0",
        "tx": {
            "feePayer": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d",
            "feePayerSignatures": [],
            "feeRatio": "0x1e",
            "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d",
            "gas": "0x76c0",
            "gasPrice": "0x5d21dba00",
            "hash": "0xd5728b5f292944492a452129080dbd431ac5c93cf0a8787f8fbad5852c060ae2",
            "nonce": "0xb",
            "signatures": [
                {
                    "R": "0xdd413e74782985ca1de84c5cfe76d25ada70d4498e12fb1f52fc543884a4c0c9",
                    "S": "0x29421d970b89bd271f5ecdbb91c9dcac70f556e38dd7516d2d711276ea0d63bc",
                    "V": "0x4e44"
                }
            ],
            "to": "0x44711e89b0c23845b5b2ed9d3716ba42b8a3e075",
            "type": "TxTypeFeeDelegatedValueTransferWithRatio",
            "typeInt": 10,
            "value": "0xf4"
        }
    }
}

Example 2 (klay_sendTransactionAsFeePayer)

// Request
curl -H "Content-Type: application/json" --data '{"jsonrpc": "2.0", "method": "klay_sendTransactionAsFeePayer", "params": [{"typeInt": 10, "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "nonce": "0x1d", "to": "0x44711E89b0c23845b5B2ed9D3716BA42b8a3e075", "gas": "0x2e6300", "gasPrice": "0x5d21dba00", "value": "0xf4", "feePayer": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "feeRatio": 30, "signatures": [{"V": "0x4e44", "R": "0x76377a0c1a050475fd06dfb192ef1724394a5f77ec6441764f7732d6ab0cbc4d", "S": "0xfb518b09210692bd530586cd484a9f6f653f9bb170e5da8b99d417e58692845"}]}], "id": 47}' http://127.0.0.1:8551

// Result
{
    "id": 47,
    "jsonrpc": "2.0",
    "result": "0xdf882a5ca0874b0e80e033957b53ee4be93918a3929f7c7c3e72bd100f8af646"
}

TxTypeValueTransferMemo

TxTypeValueTransferMemo는 사용자가 특정 메시지와 함께 KLAY를 보내려고 할 때 사용됩니다. 더 자세한 정보는 TxTypeValueTransferMemo를 참고하십시오.

Parameters

NameTypeDescription

typeInt

Integer

TxTypeValueTransferMemo를 가리키는 정수값 16입니다.

from

20-byte DATA

The address from which the transaction is sent.

to

20-byte DATA

The address to which the transaction is directed.

gas

QUANTITY

(optional, default: 90000) Integer of the gas provided for the transaction execution. Unused gas will be refunded to the sender. If the specified gas is not enough to execute the transaction, the transaction is reverted.

gasPrice

QUANTITY

(optional, default: 25000000000 Peb) Integer of the gasPrice used for each paid gas.

nonce

QUANTITY

(optional) Integer of a nonce.

value

QUANTITY

Integer of the value sent with this transaction.

input

DATA

The data sent along with the transaction.

Example

// Request
curl -H "Content-Type: application/json" --data '{"jsonrpc": "2.0", "method": "klay_signTransaction", "params": [{"typeInt": 16, "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "to": "0x44711E89b0c23845b5B2ed9D3716BA42b8a3e075", "gas": "0x76c0", "gasPrice": "0x5d21dba00", "value": "0xf4", "input": "0xb3f98adc0000000000000000000000000000000000000000000000000000000000000001"}], "id": 39}' http://127.0.0.1:8551

// Result
{
    "id": 39,
    "jsonrpc": "2.0",
    "result": {
        "raw": "0x10f8a40b8505d21dba008276c09444711e89b0c23845b5b2ed9d3716ba42b8a3e07581f494cd01b2b44584fb143824c1ea0231bebaea826b9da4b3f98adc0000000000000000000000000000000000000000000000000000000000000001f847f845824e44a0be0f4469cb23dbf057590a4d479b1a921e48bcb6ea95c0d94daa1a992124194ba008c27a2c04b02bea0a1d4bc58530d15d8fb89cbc36fc2f113503942b5607befa",
        "tx": {
            "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d",
            "gas": "0x76c0",
            "gasPrice": "0x5d21dba00",
            "hash": "0x3d174e8df748329a8eb0d591a514a6933c9407affc082a13ac05ed88e8dc90fd",
            "input": "0xb3f98adc0000000000000000000000000000000000000000000000000000000000000001",
            "nonce": "0xb",
            "signatures": [
                {
                    "R": "0xbe0f4469cb23dbf057590a4d479b1a921e48bcb6ea95c0d94daa1a992124194b",
                    "S": "0x8c27a2c04b02bea0a1d4bc58530d15d8fb89cbc36fc2f113503942b5607befa",
                    "V": "0x4e44"
                }
            ],
            "to": "0x44711e89b0c23845b5b2ed9d3716ba42b8a3e075",
            "type": "TxTypeValueTransferMemo",
            "typeInt": 16,
            "value": "0xf4"
        }
    }
}

TxTypeFeeDelegatedValueTransferMemo

트랜잭션 수수료 위임 개념을 도입한 TxTypeValueTransferMemo입니다. 더 자세한 정보는 TxTypeFeeDelegatedValueTransferMemo를 참고하십시오.

Parameters

NameTypeDescription

typeInt

Integer

TxTypeFeeDelegatedValueTransferMemo를 가리키는 정수값 17입니다.

from

20-byte DATA

The address from which the transaction is sent.

to

20-byte DATA

The address to which the transaction is directed.

gas

QUANTITY

(optional, default: 90000) Integer of the gas provided for the transaction execution. Unused gas will be refunded to the sender. If the specified gas is not enough to execute the transaction, the transaction is reverted.

gasPrice

QUANTITY

(optional, default: 25000000000 Peb) Integer of the gasPrice used for each paid gas.

nonce

QUANTITY

(optional) Integer of a nonce.

value

QUANTITY

Integer of the value sent with this transaction.

input

DATA

The data sent along with the transaction.

feePayer

20-byte DATA

The fee payer address of the transaction.

signatures

DATA

(optional - only for klay_sendTransactionAsFeePayer API) An array of signature objects. A signature object contains three fields (V, R, and S). V contains ECDSA recovery id. R contains ECDSA signature r while S contains ECDSA signature s.

Example 1 (klay_signTransaction)

// Request
curl -H "Content-Type: application/json" --data '{"jsonrpc": "2.0", "method": "klay_signTransaction", "params": [{"typeInt": 17, "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "to": "0x44711E89b0c23845b5B2ed9D3716BA42b8a3e075", "gas": "0x76c0", "gasPrice": "0x5d21dba00", "value": "0xf4", "input": "0xb3f98adc0000000000000000000000000000000000000000000000000000000000000001", "feePayer": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d"}], "id": 80}' http://127.0.0.1:8551

// Result
{
    "id": 80,
    "jsonrpc": "2.0",
    "result": {
        "raw": "0x11f8ba0b8505d21dba008276c09444711e89b0c23845b5b2ed9d3716ba42b8a3e07581f494cd01b2b44584fb143824c1ea0231bebaea826b9da4b3f98adc0000000000000000000000000000000000000000000000000000000000000001f847f845824e43a0e8daa1ec0c5fd4201cb914382104185ce2b6eab31b488616f245a1da58c6c950a028587ef4fa5c6dad2b4090a6d452692d1b8a3e90b2b6f7902a983c4a88521f6c94cd01b2b44584fb143824c1ea0231bebaea826b9dc0",
        "tx": {
            "feePayer": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d",
            "feePayerSignatures": [],
            "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d",
            "gas": "0x76c0",
            "gasPrice": "0x5d21dba00",
            "hash": "0x44050059cd96ca35461a895d2eda8fec83c725c782ca22a29be6babd0cca7348",
            "input": "0xb3f98adc0000000000000000000000000000000000000000000000000000000000000001",
            "nonce": "0xb",
            "signatures": [
                {
                    "R": "0xe8daa1ec0c5fd4201cb914382104185ce2b6eab31b488616f245a1da58c6c950",
                    "S": "0x28587ef4fa5c6dad2b4090a6d452692d1b8a3e90b2b6f7902a983c4a88521f6c",
                    "V": "0x4e43"
                }
            ],
            "to": "0x44711e89b0c23845b5b2ed9d3716ba42b8a3e075",
            "type": "TxTypeFeeDelegatedValueTransferMemo",
            "typeInt": 17,
            "value": "0xf4"
        }
    }
}

Example 2 (klay_sendTransactionAsFeePayer)

// Request
curl -H "Content-Type: application/json" --data '{"jsonrpc": "2.0", "method": "klay_sendTransactionAsFeePayer", "params": [{"typeInt": 17, "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "to": "0x44711E89b0c23845b5B2ed9D3716BA42b8a3e075", "gas": "0x4a380", "gasPrice": "0x5d21dba00", "value": "0xf4", "input": "0xb3f98adc0000000000000000000000000000000000000000000000000000000000000001", "feePayer": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "signatures": [{"V": "0x4e43", "R": "0xf343844adff1cde850c0215c78b7f9258ab158e125ee100888f454c91c51cf51", "S": "0x245f5e78ae1b52aafd18b86de6ca615af6676f3f3b70baba601748caaf1c813f"}], "nonce": "0x1e"}], "id": 81}' http://127.0.0.1:8551

// Result
{
    "id": 81,
    "jsonrpc": "2.0",
    "result": "0x83b9a07b14c57d8cef09fee549f2e068aa1c39c3b51ca14c4b663aa5486a938f"
}

TxTypeFeeDelegatedValueTransferMemoWithRatio

부분 트랜잭션 수수료 위임 개념을 도입한 TxTypeValueTransferMemo입니다. 더 자세한 정보는 TxTypeFeeDelegatedValueTransferMemoWithRatio를 참고하십시오.

Parameters

NameTypeDescription

typeInt

Integer

TxTypeFeeDelegatedValueTransferMemoWithRatio를 가리키는 정수값 18입니다.

from

20-byte DATA

The address from which the transaction is sent.

to

20-byte DATA

The address to which the transaction is directed.

gas

QUANTITY

(optional, default: 90000) Integer of the gas provided for the transaction execution. Unused gas will be refunded to the sender. If the specified gas is not enough to execute the transaction, the transaction is reverted.

gasPrice

QUANTITY

(optional, default: 25000000000 Peb) Integer of the gasPrice used for each paid gas.

nonce

QUANTITY

(optional) Integer of a nonce.

value

QUANTITY

Integer of the value sent with this transaction.

input

DATA

The data sent along with the transaction.

feePayer

20-byte DATA

The fee payer address of the transaction.

feeRatio

QUANTITY

Fee ratio of the fee payer. If it is 30, 30% of the fee will be paid by the fee payer. 70% will be paid by the sender. The range of fee ratio is 1 ~ 99, if it is out of range, the transaction will not be accepted.

signatures

DATA

(optional - only for klay_sendTransactionAsFeePayer API) An array of signature objects. A signature object contains three fields (V, R, and S). V contains ECDSA recovery id. R contains ECDSA signature r while S contains ECDSA signature s.

Example 1 (klay_signTransaction)

// Request
curl -H "Content-Type: application/json" --data '{"jsonrpc": "2.0", "method": "klay_signTransaction", "params": [{"typeInt": 18, "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "to": "0x44711E89b0c23845b5B2ed9D3716BA42b8a3e075", "gas": "0x76c0", "gasPrice": "0x5d21dba00", "value": "0xf4", "input": "0xb3f98adc0000000000000000000000000000000000000000000000000000000000000001", "feePayer": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "feeRatio": 30}], "id": 38}' http://127.0.0.1:8551

// Result
{
    "id": 38,
    "jsonrpc": "2.0",
    "result": {
        "raw": "0x12f8bb0b8505d21dba008276c09444711e89b0c23845b5b2ed9d3716ba42b8a3e07581f494cd01b2b44584fb143824c1ea0231bebaea826b9da4b3f98adc00000000000000000000000000000000000000000000000000000000000000011ef847f845824e44a0c17297d552eb7e1643491076a6c3d8c5a78768d38ce32b532bff91bbffa0d7fea00f3acdb36835ff4167e995b448693cefc1c28d9f5d5b18a4e74b000ca597758594cd01b2b44584fb143824c1ea0231bebaea826b9dc0",
        "tx": {
            "feePayer": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d",
            "feePayerSignatures": [],
            "feeRatio": "0x1e",
            "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d",
            "gas": "0x76c0",
            "gasPrice": "0x5d21dba00",
            "hash": "0xd5c1d7037b8e38781010e55ffb143caa84b5972f80c60bacd2ca324b898896cd",
            "input": "0xb3f98adc0000000000000000000000000000000000000000000000000000000000000001",
            "nonce": "0xb",
            "signatures": [
                {
                    "R": "0xc17297d552eb7e1643491076a6c3d8c5a78768d38ce32b532bff91bbffa0d7fe",
                    "S": "0xf3acdb36835ff4167e995b448693cefc1c28d9f5d5b18a4e74b000ca5977585",
                    "V": "0x4e44"
                }
            ],
            "to": "0x44711e89b0c23845b5b2ed9d3716ba42b8a3e075",
            "type": "TxTypeFeeDelegatedValueTransferMemoWithRatio",
            "typeInt": 18,
            "value": "0xf4"
        }
    }
}

Example 2 (klay_sendTransactionAsFeePayer)

// Request
curl -H "Content-Type: application/json" --data '{"jsonrpc": "2.0", "method": "klay_sendTransactionAsFeePayer", "params": [{"typeInt": 18, "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "to": "0x44711E89b0c23845b5B2ed9D3716BA42b8a3e075", "gas": "0x4a380", "gasPrice": "0x5d21dba00", "value": "0xf4", "input": "0xb3f98adc0000000000000000000000000000000000000000000000000000000000000001", "feePayer": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "feeRatio": 30, "signatures": [{"V": "0x4e43", "R": "0x5fecba257917e6677c51d94f0d9670621650a511aae86bd1e50a01c771fb68a0", "S": "0x441a9632f499dbce3d4fc974db3b431cf8ff0a2f93a6490c018796278f6edb2b"}], "nonce": "0x1f"}], "id": 81}' http://127.0.0.1:8551

// Result
{
    "id": 81,
    "jsonrpc": "2.0",
    "result": "0x34cd8c8aed102dad5201592eed848df66377fcbbe75befac4e8da8d43167e930"
}

TxTypeAccountUpdate

TxTypeAccountUpdate는 해당 계정의 키를 업데이트합니다. 더 자세한 정보는 TxTypeAccountUpdate를 참고하십시오.

Parameters

NameTypeDescription

typeInt

Integer

TxTypeAccountUpdate를 가리키는 정수값 32입니다.

from

20-byte DATA

The address from which the transaction is sent.

gas

QUANTITY

(optional, default: 90000) Integer of the gas provided for the transaction execution. Unused gas will be refunded to the sender. If the specified gas is not enough to execute the transaction, the transaction is reverted.

gasPrice

QUANTITY

(optional, default: 25000000000 Peb) Integer of the gasPrice used for each paid gas.

nonce

QUANTITY

(optional) Integer of a nonce.

key

DATA

from 계정의 RLP 인코딩된 새로운 계정 키입니다. 계정 키에 관한 자세한 정보는 Account Key에서 확인하세요.

Example

// Request
curl -H "Content-Type: application/json" --data '{"jsonrpc": "2.0", "method": "klay_signTransaction", "params": [{"typeInt": 32, "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "gas": "0x4a380", "gasPrice": "0x5d21dba00", "key": "0x01c0"}], "id": 68}' http://127.0.0.1:8551

// Result
{
    "id": 68,
    "jsonrpc": "2.0",
    "result": {
        "raw": "0x20f86c0b8505d21dba008304a38094cd01b2b44584fb143824c1ea0231bebaea826b9d8201c0f847f845824e43a0e297d840a0083b5a71e6c3c3c159699729da52e840f32dbd73074909d537924ca03408c830d52dfc60c3db82b048819a91b5537dbce8bc7ffb1e3a4bc70e0b61a2",
        "tx": {
            "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d",
            "gas": "0x4a380",
            "gasPrice": "0x5d21dba00",
            "hash": "0x50f346ff1af194b160a2096a4f290e0a6c2b0d8d026c71babd7397a55541b1c2",
            "key": "0x01c0",
            "nonce": "0xb",
            "signatures": [
                {
                    "R": "0xe297d840a0083b5a71e6c3c3c159699729da52e840f32dbd73074909d537924c",
                    "S": "0x3408c830d52dfc60c3db82b048819a91b5537dbce8bc7ffb1e3a4bc70e0b61a2",
                    "V": "0x4e43"
                }
            ],
            "type": "TxTypeAccountUpdate",
            "typeInt": 32
        }
    }
}

TxTypeFeeDelegatedAccountUpdate

트랜잭션 수수료 위임 개념을 도입한 TxTypeAccountUpdate입니다. 더 자세한 정보는 TxTypeFeeDelegatedAccountUpdate를 참고하십시오.

Parameters

NameTypeDescription

typeInt

Integer

TxTypeFeeDelegatedAccountUpdate를 가리키는 정수값 33입니다.

from

20-byte DATA

The address from which the transaction is sent.

gas

QUANTITY

(optional, default: 90000) Integer of the gas provided for the transaction execution. Unused gas will be refunded to the sender. If the specified gas is not enough to execute the transaction, the transaction is reverted.

gasPrice

QUANTITY

(optional, default: 25000000000 Peb) Integer of the gasPrice used for each paid gas.

nonce

QUANTITY

(optional) Integer of a nonce.

key

DATA

The new account key of the from account in RLP encoded format. For more information about the account key, see Account Key.

feePayer

20-byte DATA

The fee payer address of the transaction.

signatures

DATA

(optional - only for klay_sendTransactionAsFeePayer API) An array of signature objects. A signature object contains three fields (V, R, and S). V contains ECDSA recovery id. R contains ECDSA signature r while S contains ECDSA signature s.

Example 1 (klay_signTransaction)

// Request
curl -H "Content-Type: application/json" --data '{"jsonrpc": "2.0", "method": "klay_signTransaction", "params": [{"typeInt": 33, "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "gas": "0x4a380", "gasPrice": "0x5d21dba00", "key": "0x01c0", "feePayer": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d"}], "id": 85}' http://127.0.0.1:8551

// Result
{
    "id": 85,
    "jsonrpc": "2.0",
    "result": {
        "raw": "0x21f8820b8505d21dba008304a38094cd01b2b44584fb143824c1ea0231bebaea826b9d8201c0f847f845824e43a04063c2566f292e294e9e7526e6709a7efda29c131ad2f8d99d500a5ed203f5f6a0682bf0b33bfdfccfa3a810b1190c9c0e04a347733f5207d670e53fb550f22d4894cd01b2b44584fb143824c1ea0231bebaea826b9dc0",
        "tx": {
            "feePayer": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d",
            "feePayerSignatures": [],
            "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d",
            "gas": "0x4a380",
            "gasPrice": "0x5d21dba00",
            "hash": "0x0cda98d0d42afb2bfc95e256246cb86967ed815c34c8c6058172db46d28e5c70",
            "key": "0x01c0",
            "nonce": "0xb",
            "signatures": [
                {
                    "R": "0x4063c2566f292e294e9e7526e6709a7efda29c131ad2f8d99d500a5ed203f5f6",
                    "S": "0x682bf0b33bfdfccfa3a810b1190c9c0e04a347733f5207d670e53fb550f22d48",
                    "V": "0x4e43"
                }
            ],
            "type": "TxTypeFeeDelegatedAccountUpdate",
            "typeInt": 33
        }
    }
}

Example 2 (klay_sendTransactionAsFeePayer)

// Request
curl -H "Content-Type: application/json" --data '{"jsonrpc": "2.0", "method": "klay_sendTransactionAsFeePayer", "params": [{"typeInt": 33, "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "gas": "0x4a380", "gasPrice": "0x5d21dba00", "key": "0x01c0", "feePayer": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "signatures": [{"V": "0x4e43", "R": "0x87da8ac5c398bcf379d3034d72d239c8de167cafe240da13019606aad628aa8b", "S": "0x3d11215843cbc25cdf3076e4ead6272e20d72b22e0b9d498bfcd1ceff497baf4"}], "nonce": "0x20"}], "id": 78}' http://127.0.0.1:8551

// Result
{
    "id": 78,
    "jsonrpc": "2.0",
    "result": "0x63f91622a4225953cf100b334f14e85c761278a5e5401f35b6f8a8303968e0fe"
}

TxTypeFeeDelegatedAccountUpdateWithRatio

부분 트랜잭션 수수료 위임 개념을 도입한 TxTypeAccountUpdate입니다. 더 자세한 정보는 TxTypeFeeDelegatedAccountUpdateWithRatio를 참고하십시오.

Parameters

NameTypeDescription

typeInt

Integer

TxTypeFeeDelegatedAccountUpdateWithRatio를 가리키는 정수값 34입니다.

from

20-byte DATA

The address from which the transaction is sent.

gas

QUANTITY

(optional, default: 90000) Integer of the gas provided for the transaction execution. Unused gas will be refunded to the sender. If the specified gas is not enough to execute the transaction, the transaction is reverted.

gasPrice

QUANTITY

(optional, default: 25000000000 Peb) Integer of the gasPrice used for each paid gas.

nonce

QUANTITY

(optional) Integer of a nonce.

key

DATA

The new account key of the from account in RLP encoded format. For more information about the account key, see Account Key.

feePayer

20-byte DATA

The fee payer address of the transaction.

feeRatio

QUANTITY

Fee ratio of the fee payer. If it is 30, 30% of the fee will be paid by the fee payer. 70% will be paid by the sender. The range of fee ratio is 1 ~ 99, if it is out of range, the transaction will not be accepted.

signatures

DATA

(optional - only for klay_sendTransactionAsFeePayer API) An array of signature objects. A signature object contains three fields (V, R, and S). V contains ECDSA recovery id. R contains ECDSA signature r while S contains ECDSA signature s.

Example 1 (klay_signTransaction)

// Request
curl -H "Content-Type: application/json" --data '{"jsonrpc": "2.0", "method": "klay_signTransaction", "params": [{"typeInt": 34, "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "gas": "0x4a380", "gasPrice": "0x5d21dba00", "key": "0x01c0", "feePayer": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "feeRatio": 30}], "id": 78}' http://127.0.0.1:8551

// Result
{
    "id": 78,
    "jsonrpc": "2.0",
    "result": {
        "raw": "0x22f8830b8505d21dba008304a38094cd01b2b44584fb143824c1ea0231bebaea826b9d8201c01ef847f845824e43a07b86231816847655d02b68993189dcbaaae5d5168a8c1bf90ba735c1c26f4ef1a07c3e7750d0c9a3f03240ccc53125a94a7df8fce074f043d6556491869892ab9b94cd01b2b44584fb143824c1ea0231bebaea826b9dc0",
        "tx": {
            "feePayer": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d",
            "feePayerSignatures": [],
            "feeRatio": "0x1e",
            "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d",
            "gas": "0x4a380",
            "gasPrice": "0x5d21dba00",
            "hash": "0x876819fa8192f83e72b463d15b0d09bd8db4f6d3d12235f1fc2786d074cbe05e",
            "key": "0x01c0",
            "nonce": "0xb",
            "signatures": [
                {
                    "R": "0x7b86231816847655d02b68993189dcbaaae5d5168a8c1bf90ba735c1c26f4ef1",
                    "S": "0x7c3e7750d0c9a3f03240ccc53125a94a7df8fce074f043d6556491869892ab9b",
                    "V": "0x4e43"
                }
            ],
            "type": "TxTypeFeeDelegatedAccountUpdateWithRatio",
            "typeInt": 34
        }
    }
}

Example 2 (klay_sendTransactionAsFeePayer)

// Request
curl -H "Content-Type: application/json" --data '{"jsonrpc": "2.0", "method": "klay_sendTransactionAsFeePayer", "params": [{"typeInt": 34, "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "gas": "0x4a380", "gasPrice": "0x5d21dba00", "key": "0x01c0", "feePayer": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "feeRatio": 30, "signatures": [{"V": "0x4e44", "R": "0xd285969e88c3cc92471bda4bbcdce2d23eaa9bdcc47a64421de4858b7a51fd04", "S": "0x5b8123f9666580c51fdbd5a8b1d67bf1ae774e5a8e3e1ebfbf4f2024e94e82cc"}], "nonce": "0x21"}], "id": 100}' http://127.0.0.1:8551

// Result
{
    "id": 100,
    "jsonrpc": "2.0",
    "result": "0x549ee50b4f7ab804300028b3db9e9307217ffd5873ddf090413b15ffbf6c484f"
}

TxTypeSmartContractDeploy

TxTypeSmartContractDeploy는 지정된 주소에 스마트 컨트랙트를 배포합니다. 더 자세한 정보는 TxTypeSmartContractDeploy를 참고하십시오.

Parameters

NameTypeDescription

typeInt

Integer

TxTypeSmartContractDeploy를 가리키는 정수값 40입니다.

from

20-byte DATA

The address from which the transaction is sent.

to

20-byte DATA

The address to which the transaction is directed.

gas

QUANTITY

(optional, default: 90000) Integer of the gas provided for the transaction execution. Unused gas will be refunded to the sender. If the specified gas is not enough to execute the transaction, the transaction is reverted.

gasPrice

QUANTITY

(optional, default: 25000000000 Peb) Integer of the gasPrice used for each paid gas.

nonce

QUANTITY

(optional) Integer of a nonce.

value

QUANTITY

Integer of the value sent with this transaction.

input

DATA

The data sent along with the transaction.

humanReadable

Boolean

Human-Readable Address이면 true를 반환하고, 그렇지 않으면 false를 반환합니다. 현재, 이 값은 반드시 false이어야 합니다. Human-readable한 주소는 추후 지원될 예정입니다.

codeFormat

QUANTITY

스마트 컨트랙트 코드의 코드 형식입니다. 0값은 EVM을 가리킵니다.

Example

// Request
curl -H "Content-Type: application/json" --data '{"jsonrpc": "2.0", "method": "klay_signTransaction", "params": [{"typeInt": 40, "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "to": null, "gas": "0x4a380", "gasPrice": "0x5d21dba00", "value": "0x0", "input": "0x608060405234801561001057600080fd5b506040516020806102fb8339810180604052602081101561003057600080fd5b810190808051906020019092919050505033600160006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff160217905550600160026000600160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600001819055508060ff166003816100fd919061010c565b50600f6000819055505061015f565b815481835581811115610133578183600052602060002091820191016101329190610138565b5b505050565b61015c91905b80821115610158576000808201600090555060010161013e565b5090565b90565b61018d8061016e6000396000f3fe60806040526004361061003b576000357c010000000000000000000000000000000000000000000000000000000090048063b3f98adc14610040575b600080fd5b34801561004c57600080fd5b5061007c6004803603602081101561006357600080fd5b81019080803560ff16906020019092919050505061007e565b005b6000600260003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002090508060010160009054906101000a900460ff16806100e657506003805490508260ff1610155b156100f1575061015e565b60018160010160006101000a81548160ff021916908315150217905550818160010160016101000a81548160ff021916908360ff160217905550806000015460038360ff1681548110151561014257fe5b9060005260206000200160000160008282540192505081905550505b5056fea165627a7a72305820dad6d3e144a160eb6e34d8d99084ed29d207271e201aaac513007f652a26e2200029", "humanReadable": false, "codeFormat": 0}], "id": 78}' http://127.0.0.1:8551

// Result
{
    "id": 78,
    "jsonrpc": "2.0",
    "result": {
        "raw": "0x28f9036b0b8505d21dba008304a380808094cd01b2b44584fb143824c1ea0231bebaea826b9db902fb608060405234801561001057600080fd5b506040516020806102fb8339810180604052602081101561003057600080fd5b810190808051906020019092919050505033600160006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff160217905550600160026000600160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600001819055508060ff166003816100fd919061010c565b50600f6000819055505061015f565b815481835581811115610133578183600052602060002091820191016101329190610138565b5b505050565b61015c91905b80821115610158576000808201600090555060010161013e565b5090565b90565b61018d8061016e6000396000f3fe60806040526004361061003b576000357c010000000000000000000000000000000000000000000000000000000090048063b3f98adc14610040575b600080fd5b34801561004c57600080fd5b5061007c6004803603602081101561006357600080fd5b81019080803560ff16906020019092919050505061007e565b005b6000600260003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002090508060010160009054906101000a900460ff16806100e657506003805490508260ff1610155b156100f1575061015e565b60018160010160006101000a81548160ff021916908315150217905550818160010160016101000a81548160ff021916908360ff160217905550806000015460038360ff1681548110151561014257fe5b9060005260206000200160000160008282540192505081905550505b5056fea165627a7a72305820dad6d3e144a160eb6e34d8d99084ed29d207271e201aaac513007f652a26e22000298080f847f845824e44a0552594bd948e5ac9afd4db267f5f39136343faea957f91b44bc90c26c29b42c2a05b16e9ba9105bc1af84552e3d299c4fe1e3d76a521c64616d1f2ae842ddf389b",
        "tx": {
            "codeFormat": "0x0",
            "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d",
            "gas": "0x4a380",
            "gasPrice": "0x5d21dba00",
            "hash": "0x75c5d9923189be1ac6d2eb4739bcb2f0aadd3b8324e49b6228fdbc0baa074bc5",
            "humanReadable": false,
            "input": "0x608060405234801561001057600080fd5b506040516020806102fb8339810180604052602081101561003057600080fd5b810190808051906020019092919050505033600160006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff160217905550600160026000600160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600001819055508060ff166003816100fd919061010c565b50600f6000819055505061015f565b815481835581811115610133578183600052602060002091820191016101329190610138565b5b505050565b61015c91905b80821115610158576000808201600090555060010161013e565b5090565b90565b61018d8061016e6000396000f3fe60806040526004361061003b576000357c010000000000000000000000000000000000000000000000000000000090048063b3f98adc14610040575b600080fd5b34801561004c57600080fd5b5061007c6004803603602081101561006357600080fd5b81019080803560ff16906020019092919050505061007e565b005b6000600260003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002090508060010160009054906101000a900460ff16806100e657506003805490508260ff1610155b156100f1575061015e565b60018160010160006101000a81548160ff021916908315150217905550818160010160016101000a81548160ff021916908360ff160217905550806000015460038360ff1681548110151561014257fe5b9060005260206000200160000160008282540192505081905550505b5056fea165627a7a72305820dad6d3e144a160eb6e34d8d99084ed29d207271e201aaac513007f652a26e2200029",
            "nonce": "0xb",
            "signatures": [
                {
                    "R": "0x552594bd948e5ac9afd4db267f5f39136343faea957f91b44bc90c26c29b42c2",
                    "S": "0x5b16e9ba9105bc1af84552e3d299c4fe1e3d76a521c64616d1f2ae842ddf389b",
                    "V": "0x4e44"
                }
            ],
            "to": null,
            "type": "TxTypeSmartContractDeploy",
            "typeInt": 40,
            "value": "0x0"
        }
    }
}

TxTypeFeeDelegatedSmartContractDeploy

트랜잭션 수수료 위임 개념을 도입한 TxTypeSmartContractDeploy입니다. 더 자세한 내용은 TxTypeFeeDelegatedSmartContractDeploy를 참고하시기 바랍니다.

Parameters

NameTypeDescription

typeInt

Integer

TxTypeFeeDelegatedSmartContractDeploy를 가리키는 정수값 41입니다.

from

20-byte DATA

The address from which the transaction is sent.

to

20-byte DATA

The address to which the transaction is directed.

gas

QUANTITY

(optional, default: 90000) Integer of the gas provided for the transaction execution. Unused gas will be refunded to the sender. If the specified gas is not enough to execute the transaction, the transaction is reverted.

gasPrice

QUANTITY

(optional, default: 25000000000 Peb) Integer of the gasPrice used for each paid gas.

nonce

QUANTITY

(optional) Integer of a nonce.

value

QUANTITY

Integer of the value sent with this transaction.

input

DATA

The data sent along with the transaction.

humanReadable

Boolean

true if the address is humanReadable, false if the address is not humanReadable. Currently, the value should be false. Human-readable addresses will be supported later.

codeFormat

QUANTITY

The code format of smart contract code. The value 0 indicates EVM.

feePayer

20-byte DATA

The fee payer address of the transaction.

signatures

DATA

(optional - only for klay_sendTransactionAsFeePayer API) An array of signature objects. A signature object contains three fields (V, R, and S). V contains ECDSA recovery id. R contains ECDSA signature r while S contains ECDSA signature s.

Example 1 (klay_signTransaction)

// Request
curl -H "Content-Type: application/json" --data '{"jsonrpc": "2.0", "method": "klay_signTransaction", "params": [{"typeInt": 41, "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "to": null, "gas": "0x4a380", "gasPrice": "0x5d21dba00", "value": "0x0", "input": "0x608060405234801561001057600080fd5b506040516020806102fb8339810180604052602081101561003057600080fd5b810190808051906020019092919050505033600160006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff160217905550600160026000600160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600001819055508060ff166003816100fd919061010c565b50600f6000819055505061015f565b815481835581811115610133578183600052602060002091820191016101329190610138565b5b505050565b61015c91905b80821115610158576000808201600090555060010161013e565b5090565b90565b61018d8061016e6000396000f3fe60806040526004361061003b576000357c010000000000000000000000000000000000000000000000000000000090048063b3f98adc14610040575b600080fd5b34801561004c57600080fd5b5061007c6004803603602081101561006357600080fd5b81019080803560ff16906020019092919050505061007e565b005b6000600260003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002090508060010160009054906101000a900460ff16806100e657506003805490508260ff1610155b156100f1575061015e565b60018160010160006101000a81548160ff021916908315150217905550818160010160016101000a81548160ff021916908360ff160217905550806000015460038360ff1681548110151561014257fe5b9060005260206000200160000160008282540192505081905550505b5056fea165627a7a72305820dad6d3e144a160eb6e34d8d99084ed29d207271e201aaac513007f652a26e2200029", "humanReadable": false, "codeFormat": 0, "feePayer": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d"}], "id": 30}' http://127.0.0.1:8551

// Result
{
    "id": 30,
    "jsonrpc": "2.0",
    "result": {
        "raw": "0x29f903810b8505d21dba008304a380808094cd01b2b44584fb143824c1ea0231bebaea826b9db902fb608060405234801561001057600080fd5b506040516020806102fb8339810180604052602081101561003057600080fd5b810190808051906020019092919050505033600160006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff160217905550600160026000600160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600001819055508060ff166003816100fd919061010c565b50600f6000819055505061015f565b815481835581811115610133578183600052602060002091820191016101329190610138565b5b505050565b61015c91905b80821115610158576000808201600090555060010161013e565b5090565b90565b61018d8061016e6000396000f3fe60806040526004361061003b576000357c010000000000000000000000000000000000000000000000000000000090048063b3f98adc14610040575b600080fd5b34801561004c57600080fd5b5061007c6004803603602081101561006357600080fd5b81019080803560ff16906020019092919050505061007e565b005b6000600260003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002090508060010160009054906101000a900460ff16806100e657506003805490508260ff1610155b156100f1575061015e565b60018160010160006101000a81548160ff021916908315150217905550818160010160016101000a81548160ff021916908360ff160217905550806000015460038360ff1681548110151561014257fe5b9060005260206000200160000160008282540192505081905550505b5056fea165627a7a72305820dad6d3e144a160eb6e34d8d99084ed29d207271e201aaac513007f652a26e22000298080f847f845824e43a081d4349641adefcbcf5176b8ebeadc87210181630764bbe953c21a8af12174aca040816a4b6350101e9c7717e2711b8e52a0b0f900be23c6fdae73ede97979156894cd01b2b44584fb143824c1ea0231bebaea826b9dc0",
        "tx": {
            "codeFormat": "0x0",
            "feePayer": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d",
            "feePayerSignatures": [],
            "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d",
            "gas": "0x4a380",
            "gasPrice": "0x5d21dba00",
            "hash": "0x6698cb063e03f86f1efc7037691f689f9c868324d3711be0254646a08b31ccd5",
            "humanReadable": false,
            "input": "0x608060405234801561001057600080fd5b506040516020806102fb8339810180604052602081101561003057600080fd5b810190808051906020019092919050505033600160006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff160217905550600160026000600160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600001819055508060ff166003816100fd919061010c565b50600f6000819055505061015f565b815481835581811115610133578183600052602060002091820191016101329190610138565b5b505050565b61015c91905b80821115610158576000808201600090555060010161013e565b5090565b90565b61018d8061016e6000396000f3fe60806040526004361061003b576000357c010000000000000000000000000000000000000000000000000000000090048063b3f98adc14610040575b600080fd5b34801561004c57600080fd5b5061007c6004803603602081101561006357600080fd5b81019080803560ff16906020019092919050505061007e565b005b6000600260003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002090508060010160009054906101000a900460ff16806100e657506003805490508260ff1610155b156100f1575061015e565b60018160010160006101000a81548160ff021916908315150217905550818160010160016101000a81548160ff021916908360ff160217905550806000015460038360ff1681548110151561014257fe5b9060005260206000200160000160008282540192505081905550505b5056fea165627a7a72305820dad6d3e144a160eb6e34d8d99084ed29d207271e201aaac513007f652a26e2200029",
            "nonce": "0xb",
            "signatures": [
                {
                    "R": "0x81d4349641adefcbcf5176b8ebeadc87210181630764bbe953c21a8af12174ac",
                    "S": "0x40816a4b6350101e9c7717e2711b8e52a0b0f900be23c6fdae73ede979791568",
                    "V": "0x4e43"
                }
            ],
            "to": null,
            "type": "TxTypeFeeDelegatedSmartContractDeploy",
            "typeInt": 41,
            "value": "0x0"
        }
    }
}

Example 2 (klay_sendTransactionAsFeePayer)

// Request
curl -H "Content-Type: application/json" --data '{"jsonrpc": "2.0", "method": "klay_sendTransactionAsFeePayer", "params": [{"typeInt": 41, "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "to": null, "gas": "0x4a380", "gasPrice": "0x5d21dba00", "value": "0x0", "input": "0x608060405234801561001057600080fd5b506040516020806102fb8339810180604052602081101561003057600080fd5b810190808051906020019092919050505033600160006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff160217905550600160026000600160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600001819055508060ff166003816100fd919061010c565b50600f6000819055505061015f565b815481835581811115610133578183600052602060002091820191016101329190610138565b5b505050565b61015c91905b80821115610158576000808201600090555060010161013e565b5090565b90565b61018d8061016e6000396000f3fe60806040526004361061003b576000357c010000000000000000000000000000000000000000000000000000000090048063b3f98adc14610040575b600080fd5b34801561004c57600080fd5b5061007c6004803603602081101561006357600080fd5b81019080803560ff16906020019092919050505061007e565b005b6000600260003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002090508060010160009054906101000a900460ff16806100e657506003805490508260ff1610155b156100f1575061015e565b60018160010160006101000a81548160ff021916908315150217905550818160010160016101000a81548160ff021916908360ff160217905550806000015460038360ff1681548110151561014257fe5b9060005260206000200160000160008282540192505081905550505b5056fea165627a7a72305820dad6d3e144a160eb6e34d8d99084ed29d207271e201aaac513007f652a26e2200029", "humanReadable": false, "codeFormat": 0, "feePayer": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "signatures": [{"V": "0x4e44", "R": "0x25aaa9dcd863ec742299c7204d7720277ae39a277232a3b1ad61d4b665c89da9", "S": "0x4c00c144ac183f6b61224f4721e7e0d2c5f583e5793175cf35c04bdfb46e1b16"}], "nonce": "0x22"}], "id": 84}' http://127.0.0.1:8551

// Result
{
    "id": 84,
    "jsonrpc": "2.0",
    "result": "0x6568f35b350883cdc91f9c1c8bf039fde1fadbb43e2d1104f78586471a5edc48"
}

TxTypeFeeDelegatedSmartContractDeployWithRatio

부분 트랜잭션 수수료 위임 개념을 도입한 TxTypeSmartContractDeploy입니다. 더 자세한 내용은 TxTypeFeeDelegatedSmartContractDeployWithRatio를 참고하시기 바랍니다.

Parameters

NameTypeDescription

typeInt

Integer

TxTypeFeeDelegatedSmartContractDeployWithRatio를 가리키는 정수값 42입니다.

from

20-byte DATA

The address from which the transaction is sent.

to

20-byte DATA

The address to which the transaction is directed.

gas

QUANTITY

(optional, default: 90000) Integer of the gas provided for the transaction execution. Unused gas will be refunded to the sender. If the specified gas is not enough to execute the transaction, the transaction is reverted.

gasPrice

QUANTITY

(optional, default: 25000000000 Peb) Integer of the gasPrice used for each paid gas.

nonce

QUANTITY

(optional) Integer of a nonce.

value

QUANTITY

Integer of the value sent with this transaction.

input

DATA

The data sent along with the transaction.

humanReadable

Boolean

true if the address is humanReadable, false if the address is not humanReadable. Currently, the value should be false. Human-readable addresses will be supported later.

codeFormat

QUANTITY

The code format of smart contract code. The value 0 indicates EVM.

feePayer

20-byte DATA

The fee payer address of the transaction.

feeRatio

QUANTITY

Fee ratio of the fee payer. If it is 30, 30% of the fee will be paid by the fee payer. 70% will be paid by the sender. The range of fee ratio is 1 ~ 99, if it is out of range, the transaction will not be accepted.

signatures

DATA

(optional - only for klay_sendTransactionAsFeePayer API) An array of signature objects. A signature object contains three fields (V, R, and S). V contains ECDSA recovery id. R contains ECDSA signature r while S contains ECDSA signature s.

Example 1 (klay_signTransaction)

// Request
curl -H "Content-Type: application/json" --data '{"jsonrpc": "2.0", "method": "klay_signTransaction", "params": [{"typeInt": 42, "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "to": null, "gas": "0x4a380", "gasPrice": "0x5d21dba00", "value": "0x0", "input": "0x608060405234801561001057600080fd5b506040516020806102fb8339810180604052602081101561003057600080fd5b810190808051906020019092919050505033600160006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff160217905550600160026000600160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600001819055508060ff166003816100fd919061010c565b50600f6000819055505061015f565b815481835581811115610133578183600052602060002091820191016101329190610138565b5b505050565b61015c91905b80821115610158576000808201600090555060010161013e565b5090565b90565b61018d8061016e6000396000f3fe60806040526004361061003b576000357c010000000000000000000000000000000000000000000000000000000090048063b3f98adc14610040575b600080fd5b34801561004c57600080fd5b5061007c6004803603602081101561006357600080fd5b81019080803560ff16906020019092919050505061007e565b005b6000600260003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002090508060010160009054906101000a900460ff16806100e657506003805490508260ff1610155b156100f1575061015e565b60018160010160006101000a81548160ff021916908315150217905550818160010160016101000a81548160ff021916908360ff160217905550806000015460038360ff1681548110151561014257fe5b9060005260206000200160000160008282540192505081905550505b5056fea165627a7a72305820dad6d3e144a160eb6e34d8d99084ed29d207271e201aaac513007f652a26e2200029", "humanReadable": false, "codeFormat": 0, "feePayer": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "feeRatio": 30}], "id": 49}' http://127.0.0.1:8551

// Result
{
    "id": 49,
    "jsonrpc": "2.0",
    "result": {
        "raw": "0x2af903820b8505d21dba008304a380808094cd01b2b44584fb143824c1ea0231bebaea826b9db902fb608060405234801561001057600080fd5b506040516020806102fb8339810180604052602081101561003057600080fd5b810190808051906020019092919050505033600160006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff160217905550600160026000600160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600001819055508060ff166003816100fd919061010c565b50600f6000819055505061015f565b815481835581811115610133578183600052602060002091820191016101329190610138565b5b505050565b61015c91905b80821115610158576000808201600090555060010161013e565b5090565b90565b61018d8061016e6000396000f3fe60806040526004361061003b576000357c010000000000000000000000000000000000000000000000000000000090048063b3f98adc14610040575b600080fd5b34801561004c57600080fd5b5061007c6004803603602081101561006357600080fd5b81019080803560ff16906020019092919050505061007e565b005b6000600260003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002090508060010160009054906101000a900460ff16806100e657506003805490508260ff1610155b156100f1575061015e565b60018160010160006101000a81548160ff021916908315150217905550818160010160016101000a81548160ff021916908360ff160217905550806000015460038360ff1681548110151561014257fe5b9060005260206000200160000160008282540192505081905550505b5056fea165627a7a72305820dad6d3e144a160eb6e34d8d99084ed29d207271e201aaac513007f652a26e2200029801e80f847f845824e44a08b3bb148f0f9c5e5f73d0ab92147ca5c13e282ba645b57a36616560c5f0d1bb8a017e249300e72a0ab8fa06068993bc2b3f15d56583461801931879bc2bf48444294cd01b2b44584fb143824c1ea0231bebaea826b9dc0",
        "tx": {
            "codeFormat": "0x0",
            "feePayer": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d",
            "feePayerSignatures": [],
            "feeRatio": "0x1e",
            "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d",
            "gas": "0x4a380",
            "gasPrice": "0x5d21dba00",
            "hash": "0x0c1dceb1884c2bf8caa7c8d775a5709d912ebd03263888c10bcbee378562dd37",
            "humanReadable": false,
            "input": "0x608060405234801561001057600080fd5b506040516020806102fb8339810180604052602081101561003057600080fd5b810190808051906020019092919050505033600160006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff160217905550600160026000600160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600001819055508060ff166003816100fd919061010c565b50600f6000819055505061015f565b815481835581811115610133578183600052602060002091820191016101329190610138565b5b505050565b61015c91905b80821115610158576000808201600090555060010161013e565b5090565b90565b61018d8061016e6000396000f3fe60806040526004361061003b576000357c010000000000000000000000000000000000000000000000000000000090048063b3f98adc14610040575b600080fd5b34801561004c57600080fd5b5061007c6004803603602081101561006357600080fd5b81019080803560ff16906020019092919050505061007e565b005b6000600260003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002090508060010160009054906101000a900460ff16806100e657506003805490508260ff1610155b156100f1575061015e565b60018160010160006101000a81548160ff021916908315150217905550818160010160016101000a81548160ff021916908360ff160217905550806000015460038360ff1681548110151561014257fe5b9060005260206000200160000160008282540192505081905550505b5056fea165627a7a72305820dad6d3e144a160eb6e34d8d99084ed29d207271e201aaac513007f652a26e2200029",
            "nonce": "0xb",
            "signatures": [
                {
                    "R": "0x8b3bb148f0f9c5e5f73d0ab92147ca5c13e282ba645b57a36616560c5f0d1bb8",
                    "S": "0x17e249300e72a0ab8fa06068993bc2b3f15d56583461801931879bc2bf484442",
                    "V": "0x4e44"
                }
            ],
            "to": null,
            "type": "TxTypeFeeDelegatedSmartContractDeployWithRatio",
            "typeInt": 42,
            "value": "0x0"
        }
    }
}

Example 2 (klay_sendTransactionAsFeePayer)

// Request
curl -H "Content-Type: application/json" --data '{"jsonrpc": "2.0", "method": "klay_sendTransactionAsFeePayer", "params": [{"typeInt": 42, "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "to": null, "gas": "0x4a380", "gasPrice": "0x5d21dba00", "value": "0x0", "input": "0x608060405234801561001057600080fd5b506040516020806102fb8339810180604052602081101561003057600080fd5b810190808051906020019092919050505033600160006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff160217905550600160026000600160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600001819055508060ff166003816100fd919061010c565b50600f6000819055505061015f565b815481835581811115610133578183600052602060002091820191016101329190610138565b5b505050565b61015c91905b80821115610158576000808201600090555060010161013e565b5090565b90565b61018d8061016e6000396000f3fe60806040526004361061003b576000357c010000000000000000000000000000000000000000000000000000000090048063b3f98adc14610040575b600080fd5b34801561004c57600080fd5b5061007c6004803603602081101561006357600080fd5b81019080803560ff16906020019092919050505061007e565b005b6000600260003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002090508060010160009054906101000a900460ff16806100e657506003805490508260ff1610155b156100f1575061015e565b60018160010160006101000a81548160ff021916908315150217905550818160010160016101000a81548160ff021916908360ff160217905550806000015460038360ff1681548110151561014257fe5b9060005260206000200160000160008282540192505081905550505b5056fea165627a7a72305820dad6d3e144a160eb6e34d8d99084ed29d207271e201aaac513007f652a26e2200029", "humanReadable": false, "codeFormat": 0, "feePayer": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "feeRatio": 30, "signatures": [{"V": "0x4e44", "R": "0xc4e11861dd7c2849a727c979cc96ff4dfbfddc36ffe443437e9a27a9dcd028c2", "S": "0x475dc05fe78c62ced1c3d2b260c47c3e971cd66edad28da5adeeb7de63ed9413"}], "nonce": "0x23"}], "id": 68}' http://127.0.0.1:8551

// Result
{
    "id": 68,
    "jsonrpc": "2.0",
    "result": "0xc0e14928ee5eb9b81d2c8d0303c78df0d6fa3bffaa4d5b8c3008e04230447fa6"
}

TxTypeSmartContractExecution

TxTypeSmartContractExecution는 스마트 컨트랙트를 실행하고, input에 입력된 데이터를 이용합니다. 더 자세한 정보는 TxTypeSmartContractExecution을 참고하십시오.

Parameters

NameTypeDescription

typeInt

Integer

TxTypeSmartContractExecution을 가리키는 정수값 48입니다.

from

20-byte DATA

The address from which the transaction is sent.

to

20-byte DATA

The address to which the transaction is directed.

gas

QUANTITY

(optional, default: 90000) Integer of the gas provided for the transaction execution. Unused gas will be refunded to the sender. If the specified gas is not enough to execute the transaction, the transaction is reverted.

gasPrice

QUANTITY

(optional, default: 25000000000 Peb) Integer of the gasPrice used for each paid gas.

nonce

QUANTITY

(optional) Integer of a nonce.

value

QUANTITY

Integer of the value sent with this transaction.

input

DATA

The data sent along with the transaction.

Example

// Request
curl -H "Content-Type: application/json" --data '{"jsonrpc": "2.0", "method": "klay_signTransaction", "params": [{"typeInt": 48, "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "to": "0x5614dd922069d284ac9219f53cd235935c527954", "gas": "0x4a380", "gasPrice": "0x5d21dba00", "value": "0x0", "input": "0xb3f98adc0000000000000000000000000000000000000000000000000000000000000001"}], "id": 69}' http://127.0.0.1:8551

// Result
{
    "id": 69,
    "jsonrpc": "2.0",
    "result": {
        "raw": "0x30f8a40b8505d21dba008304a380945614dd922069d284ac9219f53cd235935c5279548094cd01b2b44584fb143824c1ea0231bebaea826b9da4b3f98adc0000000000000000000000000000000000000000000000000000000000000001f847f845824e43a00e4ae419c0eaa7a8b26372250583acff5ac4958e1e93b0ef73fcf2294d3970e5a00663c79625384ceff103b4317102434cc3c5a89e71dd11056b738cb89ff5655e",
        "tx": {
            "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d",
            "gas": "0x4a380",
            "gasPrice": "0x5d21dba00",
            "hash": "0x1dc3e1b9f6fdf8aad78c7b9afea0f6ecdff98a109eb4c093aff9dfd4b4aed7f2",
            "input": "0xb3f98adc0000000000000000000000000000000000000000000000000000000000000001",
            "nonce": "0xb",
            "signatures": [
                {
                    "R": "0xe4ae419c0eaa7a8b26372250583acff5ac4958e1e93b0ef73fcf2294d3970e5",
                    "S": "0x663c79625384ceff103b4317102434cc3c5a89e71dd11056b738cb89ff5655e",
                    "V": "0x4e43"
                }
            ],
            "to": "0x5614dd922069d284ac9219f53cd235935c527954",
            "type": "TxTypeSmartContractExecution",
            "typeInt": 48,
            "value": "0x0"
        }
    }
}

TxTypeFeeDelegatedSmartContractExecution

트랜잭션 수수료 위임 개념을 도입한 TxTypeSmartContractExecution입니다. 더 자세한 내용은 TxTypeFeeDelegatedSmartContractExecution을 참고하십시오.

Parameters

NameTypeDescription

typeInt

Integer

TxTypeFeeDelegatedSmartContractExecution를 가리키는 정수값 49입니다.

from

20-byte DATA

The address from which the transaction is sent.

to

20-byte DATA

The address to which the transaction is directed.

gas

QUANTITY

(optional, default: 90000) Integer of the gas provided for the transaction execution. Unused gas will be refunded to the sender. If the specified gas is not enough to execute the transaction, the transaction is reverted.

gasPrice

QUANTITY

(optional, default: 25000000000 Peb) Integer of the gasPrice used for each paid gas.

nonce

QUANTITY

(optional) Integer of a nonce.

value

QUANTITY

Integer of the value sent with this transaction.

input

DATA

The data sent along with the transaction.

feePayer

20-byte DATA

The fee payer address of the transaction.

signatures

DATA

(optional - only for klay_sendTransactionAsFeePayer API) An array of signature objects. A signature object contains three fields (V, R, and S). V contains ECDSA recovery id. R contains ECDSA signature r while S contains ECDSA signature s.

Example 1 (klay_signTransaction)

// Request
curl -H "Content-Type: application/json" --data '{"jsonrpc": "2.0", "method": "klay_signTransaction", "params": [{"typeInt": 49, "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "to": "0x5614dd922069d284ac9219f53cd235935c527954", "gas": "0x4a380", "gasPrice": "0x5d21dba00", "value": "0x0", "input": "0xb3f98adc0000000000000000000000000000000000000000000000000000000000000001", "feePayer": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d"}], "id": 25}' http://127.0.0.1:8551

// Result
{
    "id": 25,
    "jsonrpc": "2.0",
    "result": {
        "raw": "0x31f8ba0b8505d21dba008304a380945614dd922069d284ac9219f53cd235935c5279548094cd01b2b44584fb143824c1ea0231bebaea826b9da4b3f98adc0000000000000000000000000000000000000000000000000000000000000001f847f845824e44a0ce5a5c8c3d333c3c8869715d4512707d1464a09cbe178eb48d957f6cbb958471a0481a65733bca3ef988bfb82482e057289b57706a2d435a7cabc1d0f42e8986aa94cd01b2b44584fb143824c1ea0231bebaea826b9dc0",
        "tx": {
            "feePayer": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d",
            "feePayerSignatures": [],
            "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d",
            "gas": "0x4a380",
            "gasPrice": "0x5d21dba00",
            "hash": "0x8d2d26c07ed386b618154261b5c044a84da71136397c3482e534057b7650daaf",
            "input": "0xb3f98adc0000000000000000000000000000000000000000000000000000000000000001",
            "nonce": "0xb",
            "signatures": [
                {
                    "R": "0xce5a5c8c3d333c3c8869715d4512707d1464a09cbe178eb48d957f6cbb958471",
                    "S": "0x481a65733bca3ef988bfb82482e057289b57706a2d435a7cabc1d0f42e8986aa",
                    "V": "0x4e44"
                }
            ],
            "to": "0x5614dd922069d284ac9219f53cd235935c527954",
            "type": "TxTypeFeeDelegatedSmartContractExecution",
            "typeInt": 49,
            "value": "0x0"
        }
    }
}

Example 2 (klay_sendTransactionAsFeePayer)

// Request
curl -H "Content-Type: application/json" --data '{"jsonrpc": "2.0", "method": "klay_sendTransactionAsFeePayer", "params": [{"typeInt": 49, "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "to": "0xa85553604e37603a461e9b085cdac5f713210339", "gas": "0x4a380", "gasPrice": "0x5d21dba00", "value": "0x0", "input": "0xb3f98adc0000000000000000000000000000000000000000000000000000000000000001", "feePayer": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "signatures": [{"V": "0x4e43", "R": "0x8d179a52bd2c819a6b8a61bac63ec6e68583696bb7a2968e8071cb687808e92f", "S": "0x68b47095625c2af8c9996d19d64356a54b98f23de2585af7cb21db56c24e168"}], "nonce": "0x24"}], "id": 84}' http://127.0.0.1:8551

// Result
{
    "id": 84,
    "jsonrpc": "2.0",
    "result": "0x4bc27d46fed8d402ff1f22c971ac91d066568cf9f9c4bab163842c3c17af164d"
}

TxTypeFeeDelegatedSmartContractExecutionWithRatio

부분 트랜잭션 수수료 위임 개념을 도입한 TxTypeSmartContractExecution입니다. 더 자세한 내용은 TxTypeFeeDelegatedSmartContractExecutionWithRatio을 참고하십시오.

Parameters

NameTypeDescription

typeInt

Integer

TxTypeFeeDelegatedSmartContractExecutionWithRatio를 가리키는 정수값 50입니다.

from

20-byte DATA

The address from which the transaction is sent.

to

20-byte DATA

The address to which the transaction is directed.

gas

QUANTITY

(optional, default: 90000) Integer of the gas provided for the transaction execution. Unused gas will be refunded to the sender. If the specified gas is not enough to execute the transaction, the transaction is reverted.

gasPrice

QUANTITY

(optional, default: 25000000000 Peb) Integer of the gasPrice used for each paid gas.

nonce

QUANTITY

(optional) Integer of a nonce.

value

QUANTITY

Integer of the value sent with this transaction.

input

DATA

The data sent along with the transaction.

feePayer

20-byte DATA

The fee payer address of the transaction.

feeRatio

QUANTITY

Fee ratio of the fee payer. If it is 30, 30% of the fee will be paid by the fee payer. 70% will be paid by the sender. The range of fee ratio is 1 ~ 99, if it is out of range, the transaction will not be accepted.

signatures

DATA

(optional - only for klay_sendTransactionAsFeePayer API) An array of signature objects. A signature object contains three fields (V, R, and S). V contains ECDSA recovery id. R contains ECDSA signature r while S contains ECDSA signature s.

Example 1 (klay_signTransaction)

// Request
curl -H "Content-Type: application/json" --data '{"jsonrpc": "2.0", "method": "klay_signTransaction", "params": [{"typeInt": 50, "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "to": "0x5614dd922069d284ac9219f53cd235935c527954", "gas": "0x4a380", "gasPrice": "0x5d21dba00", "value": "0x0", "input": "0xb3f98adc0000000000000000000000000000000000000000000000000000000000000001", "feePayer": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "feeRatio": 30}], "id": 13}' http://127.0.0.1:8551

// Result
{
    "id": 13,
    "jsonrpc": "2.0",
    "result": {
        "raw": "0x32f8bb0b8505d21dba008304a380945614dd922069d284ac9219f53cd235935c5279548094cd01b2b44584fb143824c1ea0231bebaea826b9da4b3f98adc00000000000000000000000000000000000000000000000000000000000000011ef847f845824e44a01aad5fc01801b4f07f2d140c6aab84e19909add2b97cc6da826bed19d62acdf2a01c8368781372890a7a339e43f0aec14c2b587604c365c2f46b075c5ea35b500594cd01b2b44584fb143824c1ea0231bebaea826b9dc0",
        "tx": {
            "feePayer": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d",
            "feePayerSignatures": [],
            "feeRatio": "0x1e",
            "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d",
            "gas": "0x4a380",
            "gasPrice": "0x5d21dba00",
            "hash": "0xae60a77bbab218ca43dfc2013a1c16a886ab9d2a2b3bdecad6fd0d68c35a65f4",
            "input": "0xb3f98adc0000000000000000000000000000000000000000000000000000000000000001",
            "nonce": "0xb",
            "signatures": [
                {
                    "R": "0x1aad5fc01801b4f07f2d140c6aab84e19909add2b97cc6da826bed19d62acdf2",
                    "S": "0x1c8368781372890a7a339e43f0aec14c2b587604c365c2f46b075c5ea35b5005",
                    "V": "0x4e44"
                }
            ],
            "to": "0x5614dd922069d284ac9219f53cd235935c527954",
            "type": "TxTypeFeeDelegatedSmartContractExecutionWithRatio",
            "typeInt": 50,
            "value": "0x0"
        }
    }
}

Example 2 (klay_sendTransactionAsFeePayer)

// Request
curl -H "Content-Type: application/json" --data '{"jsonrpc": "2.0", "method": "klay_sendTransactionAsFeePayer", "params": [{"typeInt": 50, "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "to": "0xa85553604e37603a461e9b085cdac5f713210339", "gas": "0x4a380", "gasPrice": "0x5d21dba00", "value": "0x0", "input": "0xb3f98adc0000000000000000000000000000000000000000000000000000000000000001", "feePayer": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "feeRatio": 30, "signatures": [{"V": "0x4e44", "R": "0xd742608c411371d7b1db08dc6f43adabdb9b75ec03c2fa185216103de600556b", "S": "0x24b541a84945f8bc96f563909aa0ad2c7ac8376d31a65eca7a2d79b721701170"}], "nonce": "0x25"}], "id": 44}' http://127.0.0.1:8551

// Result
{
    "id": 44,
    "jsonrpc": "2.0",
    "result": "0xbf9e14ae6145544904985fa1188af5c39242ccd34412b5e42f0923f171fef5da"
}

TxTypeCancel

TxTypeCancel는 트랜잭션 풀에서 같은 논스를 가진 트랜잭션을 취소합니다. 더 자세한 내용은 TxTypeCancel을 참고하십시오.

Parameters

NameTypeDescription

typeInt

Integer

TxTypeCancel을 가리키는 정수값 56입니다.

from

20-byte DATA

The address from which the transaction is sent.

gas

QUANTITY

(optional, default: 90000) Integer of the gas provided for the transaction execution. Unused gas will be refunded to the sender. If the specified gas is not enough to execute the transaction, the transaction is reverted.

gasPrice

QUANTITY

(optional, default: 25000000000 Peb) Integer of the gasPrice used for each paid gas.

nonce

QUANTITY

(optional) Integer of a nonce.

Example

// Request
curl -H "Content-Type: application/json" --data '{"jsonrpc": "2.0", "method": "klay_signTransaction", "params": [{"typeInt": 56, "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "gas": "0x4a380", "gasPrice": "0x5d21dba00"}], "id": 81}' http://127.0.0.1:8551

// Result
{
    "id": 81,
    "jsonrpc": "2.0",
    "result": {
        "raw": "0x38f8690b8505d21dba008304a38094cd01b2b44584fb143824c1ea0231bebaea826b9df847f845824e44a0a72b71b46fe45bdafd4d8ea170fe5394897390a1442daeb4d996038a5e94209fa04324cf8ce69b84042651e7a0d0c40159fe41a76b708ae9119143e67f5267f9a2",
        "tx": {
            "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d",
            "gas": "0x4a380",
            "gasPrice": "0x5d21dba00",
            "hash": "0xc37ed41959d4188ad51f4afd2c74cb0f6a1c4e3340d7d8290b103e22947e6843",
            "nonce": "0xb",
            "signatures": [
                {
                    "R": "0xa72b71b46fe45bdafd4d8ea170fe5394897390a1442daeb4d996038a5e94209f",
                    "S": "0x4324cf8ce69b84042651e7a0d0c40159fe41a76b708ae9119143e67f5267f9a2",
                    "V": "0x4e44"
                }
            ],
            "type": "TxTypeCancel",
            "typeInt": 56
        }
    }
}

TxTypeFeeDelegatedCancel

트랜잭션 수수료 위임 개념을 도입한 TxTypeCancel입니다. 더 자세한 정보는 TxTypeFeeDelegatedCancel를 참고하십시오.

Parameters

NameTypeDescription

typeInt

Integer

TxTypeFeeDelegatedCancel를 가리키는 정수값 57입니다.

from

20-byte DATA

The address from which the transaction is sent.

gas

QUANTITY

(optional, default: 90000) Integer of the gas provided for the transaction execution. Unused gas will be refunded to the sender. If the specified gas is not enough to execute the transaction, the transaction is reverted.

gasPrice

QUANTITY

(optional, default: 25000000000 Peb) Integer of the gasPrice used for each paid gas.

nonce

QUANTITY

(optional) Integer of a nonce.

feePayer

20-byte DATA

The fee payer address of the transaction.

signatures

DATA

(optional - only for klay_sendTransactionAsFeePayer API) An array of signature objects. A signature object contains three fields (V, R, and S). V contains ECDSA recovery id. R contains ECDSA signature r while S contains ECDSA signature s.

Example 1 (klay_signTransaction)

// Request
curl -H "Content-Type: application/json" --data '{"jsonrpc": "2.0", "method": "klay_signTransaction", "params": [{"typeInt": 57, "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "gas": "0x4a380", "gasPrice": "0x5d21dba00", "feePayer": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d"}], "id": 15}' http://127.0.0.1:8551

// Result
{
    "id": 15,
    "jsonrpc": "2.0",
    "result": {
        "raw": "0x39f87f0b8505d21dba008304a38094cd01b2b44584fb143824c1ea0231bebaea826b9df847f845824e44a0f153ef31f56eda62da8bd28138f07b39d9c4158b9f96fb4db6dd5d77f4cc31bba06f787bddc96928c5bc83669ea26d23aa75fd1640241ab28fdbffaa23f13e677994cd01b2b44584fb143824c1ea0231bebaea826b9dc0",
        "tx": {
            "feePayer": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d",
            "feePayerSignatures": [],
            "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d",
            "gas": "0x4a380",
            "gasPrice": "0x5d21dba00",
            "hash": "0x14df6ed72ca4aab0db13f9b105ff5d89a1186100969b7c2bf506c7757e278523",
            "nonce": "0xb",
            "signatures": [
                {
                    "R": "0xf153ef31f56eda62da8bd28138f07b39d9c4158b9f96fb4db6dd5d77f4cc31bb",
                    "S": "0x6f787bddc96928c5bc83669ea26d23aa75fd1640241ab28fdbffaa23f13e6779",
                    "V": "0x4e44"
                }
            ],
            "type": "TxTypeFeeDelegatedCancel",
            "typeInt": 57
        }
    }
}

Example 2 (klay_sendTransactionAsFeePayer)

// Request
curl -H "Content-Type: application/json" --data '{"jsonrpc": "2.0", "method": "klay_sendTransactionAsFeePayer", "params": [{"typeInt": 57, "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "gas": "0x4a380", "gasPrice": "0x5d21dba00", "feePayer": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "signatures": [{"V": "0x4e44", "R": "0xf276dcf90e7ba5aef0c77a940d7f360bb60d761ba0ddced96584ededf56e87d3", "S": "0x2e5feb5b09985da167cce835a93ad60d56b4c125e62da4d3379fc6bcb37ef479"}], "nonce": "0x26"}], "id": 87}' http://127.0.0.1:8551

// Result
{
    "id": 87,
    "jsonrpc": "2.0",
    "result": "0xe5a3d4be46c0bab979d307660cd2c54f73c96efca8ead4b8c919ad699e9e30a9"
}

TxTypeFeeDelegatedCancelWithRatio

부분 트랜잭션 수수료 위임 개념을 도입한 TxTypeCancel입니다. 더 자세한 정보는 TxTypeFeeDelegatedCancelWithRatio를 참고하십시오.

Parameters

NameTypeDescription

typeInt

Integer

TxTypeFeeDelegatedCancelWithRatio를 가리키는 정수값 58입니다.

from

20-byte DATA

The address from which the transaction is sent.

gas

QUANTITY

(optional, default: 90000) Integer of the gas provided for the transaction execution. Unused gas will be refunded to the sender. If the specified gas is not enough to execute the transaction, the transaction is reverted.

gasPrice

QUANTITY

(optional, default: 25000000000 Peb) Integer of the gasPrice used for each paid gas.

nonce

QUANTITY

(optional) Integer of a nonce.

feePayer

20-byte DATA

The fee payer address of the transaction.

feeRatio

QUANTITY

Fee ratio of the fee payer. If it is 30, 30% of the fee will be paid by the fee payer. 70% will be paid by the sender. The range of fee ratio is 1 ~ 99, if it is out of range, the transaction will not be accepted.

signatures

DATA

(optional - only for klay_sendTransactionAsFeePayer API) An array of signature objects. A signature object contains three fields (V, R, and S). V contains ECDSA recovery id. R contains ECDSA signature r while S contains ECDSA signature s.

Example 1 (klay_signTransaction)

// Request
curl -H "Content-Type: application/json" --data '{"jsonrpc": "2.0", "method": "klay_signTransaction", "params": [{"typeInt": 58, "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "gas": "0x4a380", "gasPrice": "0x5d21dba00", "feePayer": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "feeRatio": 30}], "id": 100}' http://127.0.0.1:8551

// Result
{
    "id": 100,
    "jsonrpc": "2.0",
    "result": {
        "raw": "0x3af8800b8505d21dba008304a38094cd01b2b44584fb143824c1ea0231bebaea826b9d1ef847f845824e43a0db346a4577ab7005271b8c6f87abce971aa84dfc99bb5b21656c6241fd48886aa07b48b59572b6c7e1cb9710a3e41a6a2064fa0afd5de5de16554d91d905a018be94cd01b2b44584fb143824c1ea0231bebaea826b9dc0",
        "tx": {
            "feePayer": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d",
            "feePayerSignatures": [],
            "feeRatio": "0x1e",
            "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d",
            "gas": "0x4a380",
            "gasPrice": "0x5d21dba00",
            "hash": "0xa49f09dda70e9571da57c6dc755cd7f21587cdafea20faa76557d4e47e8f0ce5",
            "nonce": "0xb",
            "signatures": [
                {
                    "R": "0xdb346a4577ab7005271b8c6f87abce971aa84dfc99bb5b21656c6241fd48886a",
                    "S": "0x7b48b59572b6c7e1cb9710a3e41a6a2064fa0afd5de5de16554d91d905a018be",
                    "V": "0x4e43"
                }
            ],
            "type": "TxTypeFeeDelegatedCancelWithRatio",
            "typeInt": 58
        }
    }
}

Example 2 (klay_sendTransactionAsFeePayer)

// Request
curl -H "Content-Type: application/json" --data '{"jsonrpc": "2.0", "method": "klay_sendTransactionAsFeePayer", "params": [{"typeInt": 58, "from": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "gas": "0x4a380", "gasPrice": "0x5d21dba00", "feePayer": "0xcd01b2b44584fb143824c1ea0231bebaea826b9d", "feeRatio": 30, "signatures": [{"V": "0x4e44", "R": "0x8f966ed84221298383ad1d7599a18aa461f42206284a9121a58351b1e4a51bd8", "S": "0x2272e9eb953ed69a65a392c3a67b58a981acd503abeceaf60679ddb38e4fb4b0"}], "nonce": "0x27"}], "id": 96}' http://127.0.0.1:8551

// Result
{
    "id": 96,
    "jsonrpc": "2.0",
    "result": "0xa214d6cfdfc4501a976a00038dc39d57247947c2cb7d8c79f3e647447a6370c8"
}

Last updated