caver.kct.kip17
caver.kct.kip17
giúp bạn dễ dàng xử lý hợp đồng thông minh triển khai KIP-17 dưới dạng đối tượng JavaScript trên chuỗi khối Klaytn.
caver.kct.kip17
kế thừa caver.contract để triển khai hợp đồng token KIP-17. caver.kct.kip17
giữ các thuộc tính giống như caver.contract
trong khi có các phương pháp bổ sung để triển khai các tính năng bổ sung. Phần này chỉ giới thiệu các phương pháp liên kết mới được thêm vào của caver.kct.kip17
.
Mã triển khai KIP-17 cho caver-js hiện có trên Klaytn Contracts Github Repo. KIP-17 cho caver-js hỗ trợ giao diện Ownable. Sử dụng giao diện này, bạn có thể chỉ định chủ sở hữu hợp đồng khi triển khai hợp đồng
Để biết thêm thông tin về KIP-17, hãy xem Đề xuất cải tiến Klaytn.
caver.kct.kip17.deploy
Triển khai hợp đồng token KIP-17 cho chuỗi khối Klaytn. Hợp đồng được triển khai bằng cách sử dụng caver.kct.kip17.deploy là token không thể thay thế tuân theo tiêu chuẩn KIP-17.
Sau khi triển khai thành công, lời hứa sẽ được giải quyết bằng phiên bản KIP17 mới.
Tham số
Tên | type | Mô tả |
---|---|---|
tokenInfo | đối tượng | Thông tin cần thiết để triển khai hợp đồng token KIP-17 trên chuỗi khối Klaytn. Xem bảng dưới đây để biết thông tin chi tiết. |
trình triển khai | chuỗi | đối tượng | Địa chỉ trong phiên bản keyring để triển khai hợp đồng token KIP-17. Địa chỉ này phải có đủ KLAY để triển khai. Xem Keyring để biết thêm chi tiết. Nếu bạn muốn xác định các trường của mình sẽ sử dụng khi gửi giao dịch, bạn có thể chuyển loại đối tượng làm tham số. Nếu bạn muốn sử dụng Ủy thác phí khi triển khai các hợp đồng KIP-17, bạn có thể xác định các trường liên quan đến ủy thác phí trong đối tượng. Để sử dụng các trường này, hãy tham khảo mô tả tham số của phê duyệt. |
Đối tượng tokenInfo phải chứa các thông tin sau:
Tên | Loại | Mô tả |
---|---|---|
tên | chuỗi | Tên của token. |
ký hiệu | chuỗi | Ký hiệu của token. |
Giá trị trả về
PromiEvent
: Bộ phát hiệu ứng kết hợp promise, được giải quyết bằng một phiên bản KIP17 mới. Ngoài ra, có thể xảy ra các sự kiện sau đây:
Tên | type | Mô tả |
---|---|---|
transactionHash | chuỗi | Được kích hoạt ngay sau khi giao dịch được gửi và có sẵn hàm băm giao dịch. |
biên lai | đối tượng | Được kích hoạt khi có biên lai giao dịch. Nếu bạn muốn biết về các thuộc tính bên trong đối tượng biên lai, hãy xem getTransactionReceipt. Biên lai từ các phiên bản KIP17 có thuộc tính 'sự kiện' được phân tích cú pháp qua abi thay vì thuộc tính 'bản ghi'. |
lỗi | Lỗi | Được kích hoạt nếu xảy ra lỗi trong quá trình gửi. |
Đăng ký token
Để đăng ký token trên trình khám phá khối, người tạo hợp đồng phải điền vào biểu mẫu yêu cầu gửi. Ghi lại các thông tin cụ thể được yêu cầu trên biểu mẫu.
Môi trường hợp đồng thông minh
Loại trình biên dịch: Solidity
Phiên bản trình biên dịch: v0.8.4+commit.c7e474f2
Loại giấy phép mã nguồn mở: MIT
Chi tiết hợp đồng thông minh
Tối ưu hóa: --optimize-run 200
Mã nguồn: Liên kết Github hợp đồng KIP17.
Giá trị được mã hóa ABI: kip17JsonInterface tại dev · klaytn/caver-js · GitHub
Ví dụ
caver.kct.kip17.detectInterface
Trả về thông tin của giao diện được triển khai bởi hợp đồng token. Hàm tĩnh này sẽ sử dụng kip17.detectInterface.
Tham số
Tên | Loại | Mô tả |
---|---|---|
contractAddress | chuỗi | Địa chỉ của hợp đồng token KIP-7 |
Giá trị trả về
Promise
trả về một đối tượng
chứa kết quả với các giá trị boolean cho biếu liệu giao diện KIP-17 có được triển khai hay không.
Ví dụ
caver.kct.kip17.create
Tạo một phiên bản KIP17 mới với các phương pháp và sự kiện liên kết của nó. Hàm này hoạt động tương tự như KIP17 mới.
LƯU Ý caver.kct.kip17.create
được hỗ trợ kể từ caver-js v1.6.1.
Tham số
Xem KIP17 mới .
Giá trị trả về
Xem KIP17 mới .
Ví dụ
kIP17 mới
Tạo một phiên bản KIP17 mới với các phương pháp và sự kiện liên kết của nó.
Tham số
Tên | Loại | Mô tả |
---|---|---|
tokenAddress | chuỗi | (tùy chọn) Địa chỉ của hợp đồng token KIP-17, có thể được chỉ định sau thông qua |
Giá trị trả về
Loại | Mô tả |
---|---|
đối tượng | Phiên bản KIP17 với các phương pháp và sự kiện liên kết của nó. |
Ví dụ
kip17.clone
Sao chép phiên bản KIP17 hiện tại.
Tham số
Tên | Loại | Mô tả |
---|---|---|
tokenAddress | chuỗi | (tùy chọn) Địa chỉ của hợp đồng thông minh đã triển khai token KIP-17 khác. Nếu bị bỏ qua, nó sẽ được đặt thành địa chỉ hợp đồng trong trường hợp ban đầu. |
Giá trị trả về
Loại | Mô tả |
---|---|
đối tượng | Bản sao của phiên bản KIP17 ban đầu. |
Ví dụ
kip17.detectInterface
Trả về thông tin của giao diện được triển khai bởi hợp đồng token.
Tham số
Không có
Giá trị trả về
Promise
trả về một đối tượng
chứa kết quả với các giá trị boolean cho biếu liệu giao diện KIP-17 có được triển khai hay không.
Ví dụ
kip17.supportsInterface
Trả về true
nếu hợp đồng này triển khai giao diện được xác định bởi interfaceId
.
Tham số
Tên | Loại | Mô tả |
---|---|---|
interfaceId | chuỗi | InterfaceId cần được kiểm tra. |
Giá trị trả về
Promise
trả về boolean
: true
nếu hợp đồng này triển khai giao diện được xác định bởi interfaceId
.
Ví dụ
kip17.name
Trả về tên của token.
Tham số
Không có
Giá trị trả về
Promise
trả về chuỗi
: Tên của token.
Ví dụ
kip17.symbol
Trả về ký hiệu của token.
Tham số
Không có
Giá trị trả về
Promise
trả về chuỗi
: Ký hiệu của token.
Ví dụ
kip17.totalSupply
Trả về tổng số token được tạo bởi hợp đồng.
Tham số
Không có
Giá trị trả về
Promise
trả về BigNumber
: Tổng số token.
Ví dụ
kip17.tokenURI
Trả về URI cho id token đã cho.
Tham số
Tên | type | Mô tả |
---|---|---|
tokenId | BigNumber | chuỗi | số | Id của token. |
LƯU Ý Tham số tokenId
chấp nhận loại số
nhưng nếu giá trị được cung cấp nằm ngoài phạm vi được giới hạn bởi number.MAX_SAFE_INTEGER, điều đó có thể gây ra kết quả không mong muốn hoặc lỗi. Trong trường hợp này, bạn nên sử dụng loại BigNumber
, đặc biệt đối với giá trị đầu vào dạng số có kích thước uint256
.
Giá trị trả về
Promise
trả về chuỗi
: URI của token đã cho.
Ví dụ
kip17.tokenOfOwnerByIndex
Tìm kiếm danh sách token của chủ sở hữu
cho chỉ mục đã cho và trả về id token của token được xác định tại chỉ mục phù hợp trong danh sách nếu có kết quả khớp.ù hợp trong danh sách nếu có kết quả khớp.
Tham số
Tên | Loại | Mô tả |
---|---|---|
chủ sở hữu | chuỗi | Địa chỉ của tài khoản sở hữu token. |
chỉ mục | BigNumber | chuỗi | số | Chỉ mục của token trong danh sách token của chủ sở hữu. |
LƯU Ý Tham số index
chấp nhận loại số
nhưng nếu giá trị được cung cấp nằm ngoài phạm vi được giới hạn bởi number.MAX_SAFE_INTEGER, điều đó có thể gây ra kết quả không mong muốn hoặc lỗi. Trong trường hợp này, bạn nên sử dụng loại BigNumber
, đặc biệt đối với giá trị đầu vào dạng số có kích thước uint256
.
Giá trị trả về
Promise
trả về BigNumber
: Id của token.
Ví dụ
kip17.tokenByIndex
Tìm kiếm danh sách tất cả các token trong hợp đồng này cho chỉ mục đã cho và trả về id token của token được xác định tại chỉ mục phù hợp trong danh sách nếu có kết quả khớp.phù hợp trong danh sách nếu có kết quả khớp. Hoàn nguyên nếu chỉ số lớn hơn hoặc bằng tổng số token.
Tham số
Tên | type | Mô tả |
---|---|---|
chỉ mục | BigNumber | string | number | Chỉ mục của token sẽ được truy vấn. |
LƯU Ý Tham số index
chấp nhận loại số
nhưng nếu giá trị được cung cấp nằm ngoài phạm vi được giới hạn bởi number.MAX_SAFE_INTEGER, điều đó có thể gây ra kết quả không mong muốn hoặc lỗi. Trong trường hợp này, bạn nên sử dụng loại BigNumber
, đặc biệt đối với giá trị đầu vào dạng số có kích thước uint256
.
Giá trị trả về
Promise
trả về BigNumber
: Id của token.
Ví dụ
kip17.balanceOf
Trả về số dư của địa chỉ tài khoản đã cho. Số dư của tài khoản trong KIP-17 là tổng số NFT (Token không thể thay thế) thuộc sở hữu của tài khoản.
Tham số
Tên | Loại | Mô tả |
---|---|---|
address | chuỗi | Địa chỉ của tài khoản sẽ được kiểm tra số dư. |
Giá trị trả về
Promise
trả về BigNumber
: Số dư tài khoản.
Ví dụ
kip17.ownerOf
Trả về địa chỉ của chủ sở hữu id token đã chỉ định.
Tham số
Tên | Loại | Mô tả |
---|---|---|
tokenId | BigNumber | chuỗi | số | Id của token. |
LƯU Ý Tham số tokenId
chấp nhận loại số
nhưng nếu giá trị được cung cấp nằm ngoài phạm vi được giới hạn bởi number.MAX_SAFE_INTEGER, điều đó có thể gây ra kết quả không mong muốn hoặc lỗi. Trong trường hợp này, bạn nên sử dụng loại BigNumber
, đặc biệt đối với giá trị đầu vào dạng số có kích thước uint256
.
Giá trị trả về
Promise
trả về chuỗi
: Địa chỉ của tài khoản sở hữu token đã cho.
Ví dụ
kip17.getApproved
Trả về địa chỉ được phép chuyển token này hoặc địa chỉ 'không' nếu không có địa chỉ nào được phê duyệt. Thao tác sẽ hoàn nguyên nếu id token đã cho không tồn tại.
Tham số
Tên | Loại | Mô tả |
---|---|---|
tokenId | BigNumber | chuỗi | số | Id của token. |
LƯU Ý Tham số tokenId
chấp nhận loại số
nhưng nếu giá trị được cung cấp nằm ngoài phạm vi được giới hạn bởi number.MAX_SAFE_INTEGER, điều đó có thể gây ra kết quả không mong muốn hoặc lỗi. Trong trường hợp này, bạn nên sử dụng loại BigNumber
, đặc biệt đối với giá trị đầu vào dạng số có kích thước uint256
.
Giá trị trả về
Promise
trả về chuỗi
: Địa chỉ của tài khoản có quyền chuyển token đã cho.
Ví dụ
kip17.isApprovedForAll
Trả về true
nếu một người vận hành
được chấp thuận chuyển tất cả các token thuộc về chủ sở hữu
.
Tham số
Tên | Loại | Mô tả |
---|---|---|
chủ sở hữu | chuỗi | Địa chỉ của tài khoản sở hữu token và đã cho phép người vận hành gửi tất cả các token. |
người vận hành | chuỗi | Địa chỉ của tài khoản được phê duyệt để gửi tất cả token của chủ sở hữu thay cho chủ sở hữu. |
Giá trị trả về
Promise
trả lạiboolean
: true
nếu một người vận hành
được chấp thuận để gửi tất cả các token thuộc về chủ sở hữu
.
Ví dụ
kip17.isMinter
Trả về true
nếu tài khoản đã cho là người tạo token có thể phát hành token mới trong hợp đồng hiện tại tuân theo KIP-17.
Tham số
Tên | type | Mô tả |
---|---|---|
address | chuỗi | Địa chỉ của tài khoản cần kiểm tra xem có quyền tạo hay không. |
Giá trị trả về
Promise
trả về boolean
: true
nếu tài khoản là một người tạo.
Ví dụ
kip17.paused
Trả về true
nếu hợp đồng bị tạm dừng hoặc trả về false
.
Tham số
Không có
Giá trị trả về
Promise
trả về boolean
: true
nếu hợp đồng bị tạm dừng.
Ví dụ
kip17.isPauser
Trả về true
nếu tài khoản đã cho là người tạm dừng có thể tạm dừng chuyển token.
Tham số
Tên | type | Mô tả |
---|---|---|
address | chuỗi | Địa chỉ của tài khoản đã được kiểm tra để có quyền tạm dừng chuyển token. |
Giá trị trả về
Promise
trả về Boolean
: true
nếu tài khoản là trình tạm dừng.
Ví dụ
kip17.approve
Phê duyệt một địa chỉ khác để chuyển token của id token đã cho. Địa chỉ số 0 cho biết không có địa chỉ nào được phê duyệt. Chỉ có thể có một địa chỉ được phê duyệt cho mỗi token. Phương pháp này chỉ được phép gọi bởi chủ sở hữu token hoặc người vận hành được phê duyệt.
Lưu ý rằng phương pháp này sẽ gửi một giao dịch đến mạng lưới Klaytn, mạng này sẽ tính phí giao dịch cho người gửi.
Tham số
Tên | Loại | Mô tả |
---|---|---|
đến | chuỗi | Địa chỉ của tài khoản sử dụng token thay cho chủ sở hữu. |
tokenId | BigNumber | chuỗi | số | Id của token mà người chi tiêu được phép sử dụng. |
sendParam | đối tượng | (tùy chọn) Một đối tượng có tham số xác định để gửi giao dịch. |
LƯU Ý Tham số tokenId
chấp nhận loại số
nhưng nếu giá trị được cung cấp nằm ngoài phạm vi được giới hạn bởi number.MAX_SAFE_INTEGER, điều đó có thể gây ra kết quả không mong muốn hoặc lỗi. Trong trường hợp này, bạn nên sử dụng loại BigNumber
, đặc biệt đối với giá trị đầu vào dạng số có kích thước uint256
.
Đối tượng sendParam có thể chứa các thông tin sau:
Tên | Loại | Mô tả |
---|---|---|
từ | chuỗi | (tùy chọn) Địa chỉ mà giao dịch sẽ được gửi từ đó. Nếu bỏ qua tham số này thì sẽ được thiết lập bởi |
gas | số | chuỗi | (tùy chọn) Lượng gas tối đa được cung cấp cho giao dịch này (giới hạn gas). Nếu bị bỏ qua, nó sẽ được thiết lập bởi caver-js bằng cách gọi |
giá gas | số | chuỗi | (tùy chọn) Giá gas tính bằng peb để sử dụng cho giao dịch này. Nếu bị bỏ qua, nó sẽ được thiết lập bởi caver-js bằng cách gọi |
giá trị | Số | Chuỗi | BN | Số lớn | (tùy chọn) Giá trị được chuyển trong peb. |
feeDelegation | boolean | (tùy chọn, mặc định |
feePayer | chuỗi | (tùy chọn) Địa chỉ của người trả phí thanh toán phí giao dịch. Khi |
feeRatio | chuỗi | (tùy chọn) Tỷ lệ phí giao dịch mà người trả phí sẽ phải chịu. Nếu |
LƯU Ý feeDelegation
, feePayer
và feeRatio
được hỗ trợ kể từ phiên bản caver-jsv1.6.1.
Giá trị trả về
Promise
trả về đối tượng
- Biên lai chứa kết quả thực hiện giao dịch. Nếu bạn muốn biết về các thuộc tính bên trong đối tượng biên nhận, hãy xem mô tả của getTransactionReceipt. Biên lai từ các phiên bản KIP-17 có thuộc tính 'sự kiện' được phân tích cú pháp qua ABI thay vì thuộc tính 'bản ghi'.
Ví dụ
kip17.setApprovalForAll
Phê duyệt người vận hành đã cho đến
hoặc không cho phép người vận hành đã cho chuyển tất cả token của chủ sở hữu.
Lưu ý rằng phương pháp setApprovalForAll sẽ gửi giao dịch đến mạng lưới Klaytn, mạng này sẽ tính phí giao dịch cho người gửi.
Tham số
Tên | Loại | Mô tả |
---|---|---|
đến | chuỗi | Địa chỉ của tài khoản được phê duyệt/cấm chuyển tất cả các token của chủ sở hữu. |
chấp thuận | Boolean | Người vận hành này sẽ được phê duyệt nếu |
sendParam | đối tượng | (tùy chọn) Một đối tượng có tham số xác định để gửi giao dịch. Để biết thêm thông tin về sendParam, hãy tham khảo mô tả tham số của phê duyệt. |
Giá trị trả về
Promise
trả về đối tượng
- Biên lai chứa kết quả thực hiện giao dịch. Nếu bạn muốn biết về các thuộc tính bên trong đối tượng biên nhận, hãy xem mô tả của getTransactionReceipt. Biên lai từ các phiên bản KIP-17 có thuộc tính 'sự kiện' được phân tích cú pháp qua ABI thay vì thuộc tính 'bản ghi'.
Ví dụ
kip17.transferFrom
Chuyển token của id token đã cho, tokenId
từ số dư của chủ sở hữu token sang địa chỉ khác. Địa chỉ được ủy quyền để gửi token của chủ sở hữu token (người vận hành) hoặc chính chủ sở hữu token sẽ thực hiện giao dịch chuyển token này. Do đó, tài khoản được ủy quyền hoặc chủ sở hữu token phải là người gửi giao dịch này và địa chỉ phải được cung cấp tại sendParam.from
hoặc kip17Instance.options.from
. Trừ khi cả sendParam.from
và kip17Instance.options.from
đều được cung cấp, nếu không sẽ xảy ra lỗi. Bạn nên sử dụng safeTransferFrom bất cứ khi nào có thể thay vì phương pháp này.
Lưu ý rằng việc gửi giao dịch này sẽ tính phí giao dịch cho người gửi giao dịch.
Tham số
Tên | Loại | Mô tả |
---|---|---|
từ | chuỗi | Địa chỉ của chủ sở hữu hoặc người vận hành được phê duyệt của token đã cho. |
đến | chuỗi | Địa chỉ tài khoản nhận token. |
tokenId | BigNumber | chuỗi | số | Id của token bạn muốn chuyển. |
sendParam | đối tượng | (tùy chọn) Một đối tượng có tham số xác định để gửi giao dịch. Để biết thêm thông tin về sendParam, hãy tham khảo mô tả tham số của phê duyệt. |
LƯU Ý Tham số tokenId
chấp nhận loại số
nhưng nếu giá trị được cung cấp nằm ngoài phạm vi được giới hạn bởi number.MAX_SAFE_INTEGER, điều đó có thể gây ra kết quả không mong muốn hoặc lỗi. Trong trường hợp này, bạn nên sử dụng loại BigNumber
, đặc biệt đối với giá trị đầu vào dạng số có kích thước uint256
.
Giá trị trả về
Promise
trả về đối tượng
- Biên lai chứa kết quả thực hiện giao dịch. Nếu bạn muốn biết về các thuộc tính bên trong đối tượng biên nhận, hãy xem mô tả của getTransactionReceipt. Biên lai từ các phiên bản KIP-17 có thuộc tính 'sự kiện' được phân tích cú pháp qua ABI thay vì thuộc tính 'bản ghi'.
Ví dụ
kip17.safeTransferFrom
Chuyển an toàn token của id token đã cho tokenId
từ số dư của chủ sở hữu token sang địa chỉ khác. Địa chỉ được ủy quyền để gửi token của chủ sở hữu token (người vận hành) hoặc chính chủ sở hữu token sẽ thực hiện giao dịch chuyển token này. Do đó, địa chỉ được ủy quyền hoặc chủ sở hữu token phải là người gửi giao dịch này có địa chỉ phải được cung cấp tại sendParam.from
hoặc kip17Instance.options.from
. Trừ khi cả sendParam.from
và kip17Instance.options.from
đều được cung cấp, nếu không sẽ xảy ra lỗi.
Nếu địa chỉ đến
là một địa chỉ hợp đồng, thì nó phải triển khai IKIP17Receiver.onKIP17Received.interface">IKIP17Receiver.onKIP17Received. Nếu không, quá trình chuyển sẽ được hoàn nguyên.
Lưu ý rằng việc gửi giao dịch này sẽ tính phí giao dịch cho người gửi giao dịch.
Tham số
Tên | Loại | Mô tả |
---|---|---|
từ | chuỗi | Địa chỉ của chủ sở hữu hoặc người vận hành được phê duyệt của token đã cho. |
đến | chuỗi | Địa chỉ tài khoản nhận token. |
tokenId | BigNumber | chuỗi | số | Id của token bạn muốn chuyển. |
data | Bộ đệm | chuỗi | số | (tùy chọn) Dữ liệu tùy chọn để gửi cùng với cuộc gọi. |
sendParam | đối tượng | (tùy chọn) Một đối tượng có tham số xác định để gửi giao dịch. Để biết thêm thông tin về sendParam, hãy tham khảo mô tả tham số của phê duyệt. |
LƯU Ý Tham số tokenId
chấp nhận loại số
nhưng nếu giá trị được cung cấp nằm ngoài phạm vi được giới hạn bởi number.MAX_SAFE_INTEGER, điều đó có thể gây ra kết quả không mong muốn hoặc lỗi. Trong trường hợp này, bạn nên sử dụng loại BigNumber
, đặc biệt đối với giá trị đầu vào dạng số có kích thước uint256
.
Giá trị trả về
Promise
trả về đối tượng
- Biên lai chứa kết quả thực hiện giao dịch. Nếu bạn muốn biết về các thuộc tính bên trong đối tượng biên nhận, hãy xem mô tả của getTransactionReceipt. Biên lai từ các phiên bản KIP-17 có thuộc tính 'sự kiện' được phân tích cú pháp qua ABI thay vì thuộc tính 'bản ghi'.
Ví dụ
kip17.addMinter
Thêm tài khoản với tư cách là người tạo, người được phép tạo token.
Lưu ý rằng phương pháp addMinter sẽ gửi một giao dịch đến mạng lưới Klaytn, mạng này sẽ tính phí giao dịch cho người gửi.
Tham số
Tên | type | Mô tả |
---|---|---|
tài khoản | chuỗi | Địa chỉ của tài khoản sẽ được thêm vào trong vai trò người tạo. |
sendParam | đối tượng | (tùy chọn) Một đối tượng có tham số xác định để gửi giao dịch. Để biết thêm thông tin về sendParam, hãy tham khảo mô tả tham số của phê duyệt. |
LƯU Ý Nếu sendParam.from
hoặc kip17.options.from
được cung cấp, thì đó phải là một người tạm dừng có PauserRole.là một người tạo.
Giá trị trả về
Promise
trả về đối tượng
- Biên lai chứa kết quả thực hiện giao dịch. Nếu bạn muốn biết về các thuộc tính bên trong đối tượng biên nhận, hãy xem mô tả của getTransactionReceipt. Biên lai từ các phiên bản KIP-17 có thuộc tính 'sự kiện' được phân tích cú pháp qua ABI thay vì thuộc tính 'bản ghi'.
Ví dụ
kip17.renounceMinter
Từ bỏ quyền tạo token. Chỉ một địa chỉ người tạo mới có thể từ bỏ quyền tạo.
Lưu ý rằng phương pháp renounceMinter sẽ gửi một giao dịch đến mạng lưới Klaytn, mạng này sẽ tính phí giao dịch cho người gửi.
Tham số
Tên | type | Mô tả |
---|---|---|
sendParam | đối tượng | (tùy chọn) Một đối tượng có tham số xác định để gửi giao dịch. Để biết thêm thông tin về sendParam, hãy tham khảo mô tả tham số của phê duyệt. |
Nếu sendParam.from
hoặc kip17.options.from
đã được cung cấp, thì đó phải là một minter với MinterRole.
Giá trị trả về
Promise
trả về đối tượng
- Biên lai chứa kết quả thực hiện giao dịch. Nếu bạn muốn biết về các thuộc tính bên trong đối tượng biên nhận, hãy xem mô tả của getTransactionReceipt. Biên lai từ các phiên bản KIP-17 có thuộc tính 'sự kiện' được phân tích cú pháp qua ABI thay vì thuộc tính 'bản ghi'.
Ví dụ
kip17.mintWithTokenURI
Tạo token với uri đã cho và gán chúng cho tài khoản đã cho. Phương pháp này làm tăng tổng nguồn cung của token này.
Lưu ý rằng phương pháp mintWithTokenURI sẽ gửi một giao dịch đến mạng lưới Klaytn, mạng này sẽ tính phí giao dịch cho người gửi.
Tham số
Tên | Loại | Mô tả |
---|---|---|
đến | chuỗi | Địa chỉ của tài khoản mà token tạo sẽ được phát hành. |
tokenId | BigNumber | chuỗi | số | Id của token sẽ được tạo. |
tokenURI | chuỗi | Chuỗi uri của token sẽ được tạo. |
sendParam | đối tượng | (tùy chọn) Một đối tượng có tham số xác định để gửi giao dịch. Để biết thêm thông tin về sendParam, hãy tham khảo mô tả tham số của phê duyệt. |
LƯU Ý Tham số tokenId
chấp nhận loại số
nhưng nếu giá trị được cung cấp nằm ngoài phạm vi được giới hạn bởi number.MAX_SAFE_INTEGER, điều đó có thể gây ra kết quả không mong muốn hoặc lỗi. Trong trường hợp này, bạn nên sử dụng loại BigNumber
, đặc biệt đối với giá trị đầu vào dạng số có kích thước uint256
.
LƯU Ý Nếu sendParam.from
hoặc kip17.options.from
được cung cấp, thì đó phải là một người tạm dừng có PauserRole.là một người tạo có vai trò MinterRole.
Giá trị trả về
Promise
trả về đối tượng
- Biên lai chứa kết quả thực hiện giao dịch. Nếu bạn muốn biết về các thuộc tính bên trong đối tượng biên nhận, hãy xem mô tả của getTransactionReceipt. Biên lai từ các phiên bản KIP-17 có thuộc tính 'sự kiện' được phân tích cú pháp qua ABI thay vì thuộc tính 'bản ghi'.
Ví dụ
kip17.burn
Hủy token của id token đã cho. Nếu không cung cấp sendParam.from
hoặc kip17.options.from
thì sẽ xảy ra lỗi.
Lưu ý rằng phương pháp ghi sẽ gửi một giao dịch đến mạng lưới Klaytn, mạng này sẽ tính phí giao dịch cho người gửi.
Tham số
Tên | Loại | Mô tả |
---|---|---|
tokenId | BigNumber | chuỗi | số | Id của token sẽ bị phá hủy. |
sendParam | đối tượng | (tùy chọn) Một đối tượng có tham số xác định để gửi giao dịch. Để biết thêm thông tin về sendParam, hãy tham khảo mô tả tham số của phê duyệt. |
LƯU Ý Tham số tokenId
chấp nhận loại số
nhưng nếu giá trị được cung cấp nằm ngoài phạm vi được giới hạn bởi number.MAX_SAFE_INTEGER, điều đó có thể gây ra kết quả không mong muốn hoặc lỗi. Trong trường hợp này, bạn nên sử dụng loại BigNumber
, đặc biệt đối với giá trị đầu vào dạng số có kích thước uint256
.
Giá trị trả về
Promise
trả về đối tượng
- Biên lai chứa kết quả thực hiện giao dịch. Nếu bạn muốn biết về các thuộc tính bên trong đối tượng biên nhận, hãy xem mô tả của getTransactionReceipt. Biên lai từ các phiên bản KIP-17 có thuộc tính 'sự kiện' được phân tích cú pháp qua ABI thay vì thuộc tính 'bản ghi'.
Ví dụ