caver.account
caver.account는 계정 업데이트시 사용 되며 Account에 관련된 기능을 제공하는 패키지입니다.

Class

계정

const account = new caver.account(address, accountKey)
Account는 Klaytn 계정의 AccountKey를 업데이트하기 위해 필요한 정보를 포함하는 클래스입니다. caver.account 패키지의 기본 클래스입니다. 공개키(들)을 이용해 Account 인스턴스를 만들고자 한다면 caver.account.create를 참고하세요.
속성
이름
타입
설명
주소
string
업데이트 할 계정의 주소입니다.
accountKey
객체
계정에 사용될 새 accountKey입니다. AccountKeyLegacy, AccountKeyPublic, AccountKeyFail, AccountKeyWeightedMultiSig 또는 AccountKeyRoleBased의 인스턴스일 수 있습니다. 트랜잭션이 실행되면 Klaytn에 저장된 계정의 accountKey가 이렇게 변경됩니다.

AccountKeyLegacy

const accountKeyLegacy = new caver.account.accountKey.accountKeyLegacy()
AccountKeyLegacyAccountKeyLegacy를 통해 Klaytn 계정의 AccountKey를 업데이트할 때 사용됩니다. AccountKeyLegacy를 가지고 Account 인스턴스를 생성하고자 한다면 caver.account.createWithAccountKeyLegacy를 참고하세요.

AccountKeyPublic

const accountKeyPublic = new caver.account.accountKey.accountKeyPublic(publicKey)
AccountKeyPublicAccountKeyPublic를 이용해 Klaytn 계정의 AccountKey를 업데이트할 때 사용됩니다. AccountKey를 AccountKeyPublic로 업데이트하면 기존의 AccountKey가 새로운 공개키로 바뀌며, 이는 Klaytn 트랜잭션 검증에 사용됩니다. 계정의 개인키를 주소로부터 분리할 때 필요한 업데이트입니다. 자세한 사항은 AccountUpdateAccountKey를 참고하세요.
AccountKeyPublic로 Account 인스턴스를 만들고자 한다면 caver.account.create or caver.account.createWithAccountKeyPublic를 참고하세요.
속성
이름
타입
설명
publicKey
string
공개키 문자열입니다.

AccountKeyFail

const accountKeyFail = new caver.account.accountKey.accountKeyFail()
AccountKeyFailAccountKeyFail을 통해 Klaytn 계정의 AccountKey를 업데이트할 때 사용됩니다. AccountKeyFail을 사용하여 Account 인스턴스를 만들고자 한다면 caver.account.createWithAccountKeyFail를 참고하세요.

AccountKeyWeightedMultiSig

const accountKeyWeightedMultiSig = new caver.account.accountKey.accountKeyWeightedMultiSig(threshold, weightedPublicKeys)
AccountKeyWeightedMultiSigAccountKeyWeightedMultiSig를 사용해 Klaytn 계정의 AccountKey를 업데이트할 때 사용합니다. AccountKey를 AccountKeyWeightedMultiSig로 업데이트하면 기존의 AccountKey가 새로운 공개키로 바뀌며, 이는 Klaytn 트랜잭션 검증에 사용됩니다. 계정의 개인키를 주소로부터 분리할 때 필요한 업데이트입니다. 자세한 사항은 AccountUpdateAccountKey를 참고하세요.
AccountKeyWeightedMultiSig로 Account 인스턴스를 만들고자 한다면 caver.account.create or caver.account.createWithAccountKeyWeightedMultiSig를 참고하세요.
속성
이름
타입
설명
임계값
number
검증 임계값입니다.
weightedPublicKeys
Array
WeightedPublicKey의 배열입니다.

AccountKeyRoleBased

const accountKeyRoleBased = new caver.account.accountKey.accountKeyRoleBased(accountKeyArray)
AccountKeyRoleBasedAccountKeyRoleBased를 통해 Klaytn 계정의 AccountKey를 업데이트할 때 사용됩니다. AccountKey를 AccountKeyRoleBased로 업데이트함으로써 Klaytn 트랜잭션 검증에 사용되는 각 역할에 할당된 AccountKey(들)을 변경할 수 있습니다. 자세한 사항은 AccountUpdateAccountKey를 참고하세요.
AccountKeyRoleBased로 Account 인스턴스를 만들고자 한다면 caver.account.create or caver.account.createWithAccountKeyRoleBased를 참고하세요.
속성
이름
타입
설명
accountKeyArray
Array
역할에 사용되는 키를 정의하는 배열입니다. 각 역할은 [AccountKeyLegacy, AccountKeyPublic, AccountKeyFail, AccountKeyWeightedMultiSig 또는 AccountKeyRoleBased](#accountkeylegacy)로 정의될 수 있습니다.

WeightedPublicKey

const weightedPublicKey = new caver.account.accountKey.weightedPublicKey(weight, publicKey)
WeightedPublicKey contains a public key and its weight. WeightedPublicKey는 공개키와 그 가중치를 포함하는 클래스로, AccountKeyWeightedMultiSig에 사용됩니다.
속성
이름
타입
설명
가중치
number
공개키의 가중치입니다. 공개키의 가중치 합계가 AccountKeyWeightedMultiSig 객체의 임계값을 초과하는지 여부를 확인하는 데 사용됩니다.
publicKey
string
공개키 문자열입니다.

WeightedMultiSigOptions

const weightedMultiSigOptions = new caver.account.weightedMultiSigOptions(threshold, weights)
WeightedMultiSigOptions는 임계값과 가중치를 포함합니다. WeightedMultiSigOptions는 AccountKeyWeightedMultiSig의 옵션을 정의하는 클래스입니다.
속성
이름
타입
설명
임계값
number
검증 임계값입니다.
가중치
Array
키 가중치의 배열입니다.

caver.account.create

caver.account.create(address, accountKey [, options])
주소와 accountKey를 지닌 Account 인스턴스를 생성합니다.
accountKey가 공개키 문자열인 경우, accountKey가 AccountKeyPublic인 Account 인스턴스가 생성됩니다. accountKey가 공개키 문자열을 포함한 배열인 경우, accountKey가 AccountKeyWeightedMultiSig인 Account 인스턴스가 생성됩니다. 옵션들이 마지막 파라미터로 정의되지 않은 경우 기본값으로 임계값이 1, 각 키의 가중치가 1로 설정되어 생성됩니다. accountKey가 각 역할에 사용되는 accountKeys를 포함한 배열인 경우, AccountKeyRoleBased를 지닌 Account 인스턴스가 생성됩니다. 옵션들은 WeightedMultiSigOptions를 통해 각 역할에 정의되어야 합니다. 옵션들이 정의되어 있지 않다면, 다수의 공개키를 사용하는 역할들에 대해 기본 옵션이 사용됩니다. 사용법은 아래 예시를 참고하세요.
Parameters
이름
타입
설명
주소
string
업데이트 할 계정의 주소입니다.
accountKey
string | Array
공개키 문자열, 공개키(들)의 배열, 또는 각 요소가 각 역할에 사용될 키(들) 의 배열을 포함하는 2차원 배열입니다.
options
(선택 사항) AccountKeyWeigthedMultiSig에 대한 옵션들입니다.
리턴값
타입
설명
Account
Account 인스턴스가 반환됩니다.
예시
// Create an Account instance with a public key string -> Account with AccountKeyPublic
> caver.account.create('0x{address in hex}', '0x034f1...')
Account {
_address: '0xc771822ad361898a330df0169f2382ee92f6286d',
_accountKey: AccountKeyPublic { _publicKey: '0x034f1...' }
}
// Create an Account instance with an array of public keys -> Account with AccountKeyWeightedMultiSig
> caver.account.create('0x{address in hex}', ['0x034f1...', '0xfe4b8...'])
Account {
_address: '0xc771822ad361898a330df0169f2382ee92f6286d',
_accountKey:
AccountKeyWeightedMultiSig {
_threshold: 1,
_weightedPublicKeys: [
WeightedPublicKey { _weight: 1, _publicKey: '0x034f1...' },
WeightedPublicKey { _weight: 1, _publicKey: '0xfe4b8...' }
]
}
}
// Create an Account instance with an array of public keys with WeightedMultiSigOptions -> Account with AccountKeyWeightedMultiSig
> const options = new caver.account.weightedMultiSigOptions(2, [1, 1])
> caver.account.create('0x{address in hex}', ['0x034f1...', '0xfe4b8...'], options)
Account {
_address: '0xc771822ad361898a330df0169f2382ee92f6286d',
_accountKey:
AccountKeyWeightedMultiSig {
_threshold: 2,
_weightedPublicKeys: [
WeightedPublicKey { _weight: 1, _publicKey: '0x034f1...' },
WeightedPublicKey { _weight: 1, _publicKey: '0xfe4b8...' }
]
}
}
// Create an Account instance with an array in which keys to be used for each role are defined as an array -> Account with AccountKeyRoleBased
> const publicKeys = [
['0xd8510...', '0xaa105...'],
['0xd8510...'],
['0xd8510...', '0xceeee...']
]
> caver.account.create('0x{address in hex}', publicKeys)
Account {
_address: '0xc771822ad361898a330df0169f2382ee92f6286d',
_accountKey:
AccountKeyRoleBased {
_accountKeys: [
AccountKeyWeightedMultiSig {
_threshold: 1,
_weightedPublicKeys: [
WeightedPublicKey { _weight: 1, _publicKey: '0xd8510...' },
WeightedPublicKey { _weight: 1, _publicKey: '0xaa105...' }
]
},
AccountKeyPublic { _publicKey: '0xd8510...' },
AccountKeyWeightedMultiSig {
_threshold: 1,
_weightedPublicKeys: [
WeightedPublicKey { _weight: 1, _publicKey: '0xd8510...' },
WeightedPublicKey { _weight: 1, _publicKey: '0xceeee...' }
]
}
]
}
}
// Create an Account instance with an array in which keys to be used for each role are defined as an array with an array of WeightedMultiSigOptions -> Account with AccountKeyRoleBased
> const publicKeys = [
['0xd8510...', '0xaa105...'],
['0xd8510...'],
['0xd8510...', '0xceeee...']
]
> const options = [
new caver.account.weightedMultiSigOptions(2, [1, 1]),
new caver.account.weightedMultiSigOptions(),
new caver.account.weightedMultiSigOptions(3, [1, 2])
]
> caver.account.create('0x{address in hex}', publicKeys, options)
Account {
_address: '0xc771822ad361898a330df0169f2382ee92f6286d',
_accountKey:
AccountKeyRoleBased {
_accountKeys: [
AccountKeyWeightedMultiSig {
_threshold: 2,
_weightedPublicKeys: [
WeightedPublicKey { _weight: 1, _publicKey: '0xd8510...' },
WeightedPublicKey { _weight: 1, _publicKey: '0xaa105...' }
]
},
AccountKeyPublic { _publicKey: '0xd8510...' },
AccountKeyWeightedMultiSig {
_threshold: 3,
_weightedPublicKeys: [
WeightedPublicKey { _weight: 1, _publicKey: '0xd8510...' },
WeightedPublicKey { _weight: 2, _publicKey: '0xceeee...' }
]
}
]
}
}

caver.account.createFromRLPEncoding

caver.account.createFromRLPEncoding(address, rlpEncodedKey)
RLP 인코딩된 AccountKey로부터 Account 인스턴스를 생성합니다.
Parameters
이름
타입
설명
주소
string
업데이트 할 계정의 주소입니다.
rlpEncodedKey
string
AccountKey의 RLP 인코딩된 문자열입니다.
리턴값
타입
설명
Account
Account 인스턴스가 반환됩니다.
예시
> caver.account.createFromRLPEncoding('0x{address in hex}', '0x04f84b02f848e301a102c10b598a1a3ba252acc21349d61c2fbd9bc8c15c50a5599f420cccc3291f9bf9e301a1021769a9196f523c419be50c26419ebbec34d3d6aa8b59da834212f13dbec9a9c1')
Account {
_address: '0x9ea5b871e7bef65868a0d278be3fc6cdbee543ee',
_accountKey:
AccountKeyWeightedMultiSig {
_threshold: 2,
_weightedPublicKeys: [
WeightedPublicKey { _weight: 1, _publicKey: '0x02c10...' },
WeightedPublicKey { _weight: 1, _publicKey: '0x02176...' }
]
}
}

caver.account.createWithAccountKeyLegacy

caver.account.createWithAccountKeyLegacy(address)
AccountKeyLegacy를 accountKey로 지닌 Account 인스턴스를 생성합니다.
Parameters
이름
타입
설명
주소
string
업데이트 할 계정의 주소입니다.
리턴값
타입
설명
Account
Account 인스턴스가 반환됩니다.
예시
> caver.account.createWithAccountKeyLegacy('0x{address in hex}')
Account {
_address: '0x9ea5b871e7bef65868a0d278be3fc6cdbee543ee',
_accountKey: AccountKeyLegacy {}
}

caver.account.createWithAccountKeyPublic

caver.account.createWithAccountKeyPublic(address, publicKey)
AccountKeyPublic를 accountKey로 지닌 Account 인스턴스를 생성합니다.
Parameters
이름
타입
설명
주소
string
업데이트 할 계정의 주소입니다.
publicKey
string
공개키 문자열입니다.
리턴값
타입
설명
Account
Account 인스턴스가 반환됩니다.
예시
> caver.account.createWithAccountKeyPublic('0x{address in hex}', '0xb5a9a...')
Account {
_address: '0x9ea5b871e7bef65868a0d278be3fc6cdbee543ee',
_accountKey: AccountKeyPublic { _publicKey: ,'0xb5a9a...' }
}

caver.account.createWithAccountKeyFail

caver.account.createWithAccountKeyFail(address)
AccountKeyFail를 accountKey로 지닌 Account 인스턴스를 생성합니다.
Parameters
이름
타입
설명
주소
string
업데이트 할 계정의 주소입니다.
리턴값
타입
설명
Account
Account 인스턴스가 반환됩니다.
예시
> caver.account.createWithAccountKeyFail('0x{address in hex}')
Account {
_address: '0x9ea5b871e7bef65868a0d278be3fc6cdbee543ee',
_accountKey: AccountKeyFail {}
}

caver.account.createWithAccountKeyWeightedMultiSig

caver.account.createWithAccountKeyWeightedMultiSig(address, publicKeyArray [, options])
AccountKeyWeightedMultiSig를 accountKey로 지닌 Account 인스턴스를 생성합니다.
Parameters
이름
타입
설명
주소
string
업데이트 할 계정의 주소입니다.
publicKeyArray
Array
다수의 공개키 문자열을 포함한 배열입니다.
options
(선택 사항) 임계값과 가중치 배열을 정의하는 WeightedMultiSigOptions 인스턴스입니다.
리턴값
타입
설명
Account
Account 인스턴스가 반환됩니다.
예시
// create an Account instance without options
> caver.account.createWithAccountKeyWeightedMultiSig('0x{address in hex}', ['0xb5a9a...', '0xfe4b8...'])
Account {
_address: '0xc771822ad361898a330df0169f2382ee92f6286d',
_accountKey:
AccountKeyWeightedMultiSig {
_threshold: 1,
_weightedPublicKeys: [
WeightedPublicKey { _weight: 1, _publicKey: '0xb5a9a...' },
WeightedPublicKey { _weight: 1, _publicKey: '0xfe4b8...' }
]
}
}
// create an Account instance with options
> const options = new caver.account.weightedMultiSigOptions(2, [1, 1])
> caver.account.createWithAccountKeyWeightedMultiSig('0x{address in hex}', ['0xb5a9a...', '0xfe4b8...'], options)
Account {
_address: '0xc771822ad361898a330df0169f2382ee92f6286d',
_accountKey:
AccountKeyWeightedMultiSig {
_threshold: 2,
_weightedPublicKeys: [
WeightedPublicKey { _weight: 1, _publicKey: '0xb5a9a...' },
WeightedPublicKey { _weight: 1, _publicKey: '0xfe4b8...' }
]
}
}

caver.account.createWithAccountKeyRoleBased

caver.account.createWithAccountKeyRoleBased(address, roledBasedPublicKeyArray [, options])
AccountKeyRoleBased를 accountKey로 지닌 Account 인스턴스를 생성합니다.
Parameters
이름
타입
설명
주소
string
업데이트 할 계정의 주소입니다.
roledBasedPublicKeyArray
Array
각 역할에 대해 공개키 문자열의 배열을 포함하고 있는 2차원 배열입니다.
options
Array
(선택 사항) 각 역할에 대해 WeightedMultiSigOptions 인스턴스를 포함하는 배열입니다.
리턴값
타입
설명
Account
Account 인스턴스가 반환됩니다.
예시
// create an Account instance without options
> const publicKeys = [
['0x034f1...', '0xfe4b8...'],
['0xb5a9a...'],
['0x034f1...', '0xb5a9a...']
]
> caver.account.createWithAccountKeyRoleBased('0x{address in hex}', publicKeys)
Account {
_address: '0xc771822ad361898a330df0169f2382ee92f6286d',
_accountKey:
AccountKeyRoleBased {
_accountKeys: [
AccountKeyWeightedMultiSig {
_threshold: 1,
_weightedPublicKeys: [
WeightedPublicKey { _weight: 1, _publicKey: '0x034f1...' },
WeightedPublicKey { _weight: 1, _publicKey: '0xfe4b8...' }
]
},
AccountKeyPublic { _publicKey: '0xb5a9a...' },
AccountKeyWeightedMultiSig {
_threshold: 1,
_weightedPublicKeys: [
WeightedPublicKey { _weight: 1, _publicKey: '0x034f1...' },
WeightedPublicKey { _weight: 1, _publicKey: '0xb5a9a...' }
]
}
]
}
}
// create an Account instance with options
> const publicKeys = [
['0x034f1...', '0xfe4b8...'],
['0xb5a9a...'],
['0x034f1...', '0xb5a9a...']
]
> const options = [
new caver.account.weightedMultiSigOptions(2, [1, 1]),
new caver.account.weightedMultiSigOptions(),
new caver.account.weightedMultiSigOptions(3, [1, 2])
]
> caver.account.createWithAccountKeyRoleBased('0x{address in hex}', publicKeys, options)
Account {
_address: '0xc771822ad361898a330df0169f2382ee92f6286d',
_accountKey:
AccountKeyRoleBased {
_accountKeys: [
AccountKeyWeightedMultiSig {
_threshold: 2,
_weightedPublicKeys: [
WeightedPublicKey { _weight: 1, _publicKey: '0x034f1...' },
WeightedPublicKey { _weight: 1, _publicKey: '0xfe4b8...' }
]
},
AccountKeyPublic { _publicKey: '0xb5a9a...' },
AccountKeyWeightedMultiSig {
_threshold: 3,
_weightedPublicKeys: [
WeightedPublicKey { _weight: 1, _publicKey: '0x034f1...' },
WeightedPublicKey { _weight: 2, _publicKey: '0xb5a9a...' }
]
}
]
}
}

caver.account.accountKey.decode

caver.account.accountKey.decode(rlpEncodedAccountKey)
AccountKey의 RLP 인코딩된 문자열을 디코딩하며, AccountKeyLegacy, AccountKeyPublic, AccountKeyFail, AccountKeyWeightedMultiSig 또는 AccountKeyRoleBased 인스턴스를 반환합니다.
Parameters
이름
타입
설명
rlpEncodedAccountKey
string
AccountKey의 RLP 인코딩된 문자열입니다.
리턴값
타입
설명
AccountKey 인스턴스가 반환됩니다.
예시
> caver.account.accountKey.decode('0x02a102c10b598a1a3ba252acc21349d61c2fbd9bc8c15c50a5599f420cccc3291f9bf9')
AccountKeyPublic { _publicKey: '0x02c10b598a1a3ba252acc21349d61c2fbd9bc8c15c50a5599f420cccc3291f9bf9' }

account.getRLPEncodingAccountKey

account.getRLPEncodingAccountKey()
AccountKey의 RLP 인코딩된 문자열을 반환합니다.
리턴값
타입
설명
string
AccountKey의 RLP 인코딩된 문자열입니다 .
예시
> const account = caver.account.create('0x{address in hex}', '0x034f1...')
> account.getRLPEncodingAccountKey()
'0x02a102d851040f46d61a042a787cca34ad12bc43e51f01ad0b22270cfc25c15c4b4e22'
Copy link
On this page
Class
계정
AccountKeyLegacy
AccountKeyPublic
AccountKeyFail
AccountKeyWeightedMultiSig
AccountKeyRoleBased
WeightedPublicKey
WeightedMultiSigOptions
caver.account.create
caver.account.createFromRLPEncoding
caver.account.createWithAccountKeyLegacy
caver.account.createWithAccountKeyPublic
caver.account.createWithAccountKeyFail
caver.account.createWithAccountKeyWeightedMultiSig
caver.account.createWithAccountKeyRoleBased
caver.account.accountKey.decode
account.getRLPEncodingAccountKey