集成API

CHAINFetch Bucket State

Last updated January 31, 2026

使用 Genesis JavaScript SDK 直接从区块链获取实时桶状态。返回存款总额、计数、代币分配和时间条件。

链上获取需要 UmiGenesis SDK

方法

方法发行类型描述
fetchLaunchPoolBucketV2Launch Pool获取 launch pool 桶状态
fetchPresaleBucketV2Presale获取 presale 桶状态

Launch Pool 桶

import { fetchLaunchPoolBucketV2 } from '@metaplex-foundation/genesis';
const bucket = await fetchLaunchPoolBucketV2(umi, launchPoolBucket);
console.log('Total deposits:', bucket.quoteTokenDepositTotal);
console.log('Deposit count:', bucket.depositCount);
console.log('Claim count:', bucket.claimCount);
console.log('Token allocation:', bucket.bucket.baseTokenAllocation);

Presale 桶

import { fetchPresaleBucketV2 } from '@metaplex-foundation/genesis';
const bucket = await fetchPresaleBucketV2(umi, presaleBucket);
console.log('Total deposits:', bucket.quoteTokenDepositTotal);
console.log('Deposit count:', bucket.depositCount);
console.log('Token allocation:', bucket.bucket.baseTokenAllocation);
console.log('SOL cap:', bucket.allocationQuoteTokenCap);

时间条件

每个桶有四个时间条件来控制发行阶段:

条件用途
depositStartCondition存款开始时间
depositEndCondition存款结束时间
claimStartCondition领取开始时间
claimEndCondition领取结束时间
const bucket = await fetchLaunchPoolBucketV2(umi, launchPoolBucket);
// Deposit window
const depositStart = bucket.depositStartCondition.time;
const depositEnd = bucket.depositEndCondition.time;
// Claim window
const claimStart = bucket.claimStartCondition.time;
const claimEnd = bucket.claimEndCondition.time;
console.log('Deposit starts:', new Date(Number(depositStart) * 1000));
console.log('Deposit ends:', new Date(Number(depositEnd) * 1000));
console.log('Claims start:', new Date(Number(claimStart) * 1000));
console.log('Claims end:', new Date(Number(claimEnd) * 1000));