@solana/spl-token
Version:
SPL Token Program JS API
99 lines • 4.05 kB
JavaScript
;
Object.defineProperty(exports, "__esModule", { value: true });
exports.approveCheckedInstructionData = void 0;
exports.createApproveCheckedInstruction = createApproveCheckedInstruction;
exports.decodeApproveCheckedInstruction = decodeApproveCheckedInstruction;
exports.decodeApproveCheckedInstructionUnchecked = decodeApproveCheckedInstructionUnchecked;
const buffer_layout_1 = require("@solana/buffer-layout");
const buffer_layout_utils_1 = require("@solana/buffer-layout-utils");
const web3_js_1 = require("@solana/web3.js");
const constants_js_1 = require("../constants.js");
const errors_js_1 = require("../errors.js");
const internal_js_1 = require("./internal.js");
const types_js_1 = require("./types.js");
/** TODO: docs */
exports.approveCheckedInstructionData = (0, buffer_layout_1.struct)([
(0, buffer_layout_1.u8)('instruction'),
(0, buffer_layout_utils_1.u64)('amount'),
(0, buffer_layout_1.u8)('decimals'),
]);
/**
* Construct an ApproveChecked instruction
*
* @param account Account to set the delegate for
* @param mint Mint account
* @param delegate Account authorized to transfer of tokens from the account
* @param owner Owner of the account
* @param amount Maximum number of tokens the delegate may transfer
* @param decimals Number of decimals in approve amount
* @param multiSigners Signing accounts if `owner` is a multisig
* @param programId SPL Token program account
*
* @return Instruction to add to a transaction
*/
function createApproveCheckedInstruction(account, mint, delegate, owner, amount, decimals, multiSigners = [], programId = constants_js_1.TOKEN_PROGRAM_ID) {
const keys = (0, internal_js_1.addSigners)([
{ pubkey: account, isSigner: false, isWritable: true },
{ pubkey: mint, isSigner: false, isWritable: false },
{ pubkey: delegate, isSigner: false, isWritable: false },
], owner, multiSigners);
const data = Buffer.alloc(exports.approveCheckedInstructionData.span);
exports.approveCheckedInstructionData.encode({
instruction: types_js_1.TokenInstruction.ApproveChecked,
amount: BigInt(amount),
decimals,
}, data);
return new web3_js_1.TransactionInstruction({ keys, programId, data });
}
/**
* Decode an ApproveChecked instruction and validate it
*
* @param instruction Transaction instruction to decode
* @param programId SPL Token program account
*
* @return Decoded, valid instruction
*/
function decodeApproveCheckedInstruction(instruction, programId = constants_js_1.TOKEN_PROGRAM_ID) {
if (!instruction.programId.equals(programId))
throw new errors_js_1.TokenInvalidInstructionProgramError();
if (instruction.data.length !== exports.approveCheckedInstructionData.span)
throw new errors_js_1.TokenInvalidInstructionDataError();
const { keys: { account, mint, delegate, owner, multiSigners }, data, } = decodeApproveCheckedInstructionUnchecked(instruction);
if (data.instruction !== types_js_1.TokenInstruction.ApproveChecked)
throw new errors_js_1.TokenInvalidInstructionTypeError();
if (!account || !mint || !delegate || !owner)
throw new errors_js_1.TokenInvalidInstructionKeysError();
// TODO: key checks?
return {
programId,
keys: {
account,
mint,
delegate,
owner,
multiSigners,
},
data,
};
}
/**
* Decode an ApproveChecked instruction without validating it
*
* @param instruction Transaction instruction to decode
*
* @return Decoded, non-validated instruction
*/
function decodeApproveCheckedInstructionUnchecked({ programId, keys: [account, mint, delegate, owner, ...multiSigners], data, }) {
return {
programId,
keys: {
account,
mint,
delegate,
owner,
multiSigners,
},
data: exports.approveCheckedInstructionData.decode(data),
};
}
//# sourceMappingURL=approveChecked.js.map