@silvana-one/api 0.2.8 → 0.2.9

package/src/client/sdk.gen.ts

@@ -1,7 +1,7 @@
 // This file is auto-generated by @hey-api/openapi-ts
 
 import type { Options as ClientOptions, TDataShape, Client } from '@hey-api/client-fetch';
-import type { LaunchNftCollectionData, LaunchNftCollectionResponse, LaunchNftCollectionError, LaunchTokenData, LaunchTokenResponse, LaunchTokenError, GetContractInfoData, GetContractInfoResponse, GetContractInfoError, GetNftInfoData, GetNftInfoResponse, GetNftInfoError, GetNftV2InfoData, GetNftV2InfoResponse, GetNftV2InfoError, FaucetData, FaucetResponse2, FaucetError, GetTokenInfoData, GetTokenInfoResponse, GetTokenInfoError, GetTokenBalanceData, GetTokenBalanceResponse, GetTokenBalanceError, GetNonceData, GetNonceResponse, GetNonceError, ProveData, ProveResponse, ProveError, GetProofData, GetProofResponse, GetProofError, SendTransactionData, SendTransactionResponse, SendTransactionError, TxStatusData, TxStatusResponse, TxStatusError, MintTokensData, MintTokensResponse, MintTokensError, MintNftData, MintNftResponse, MintNftError, TransferNftData, TransferNftResponse, TransferNftError, ApproveNftData, ApproveNftResponse, ApproveNftError, SellNftData, SellNftResponse, SellNftError, BuyNftData, BuyNftResponse, BuyNftError, TransferTokensData, TransferTokensResponse, TransferTokensError, AirdropTokensData, AirdropTokensResponse, AirdropTokensError, RedeemTokensData, RedeemTokensResponse, RedeemTokensError, BurnTokensData, BurnTokensResponse, BurnTokensError, TokenBidData, TokenBidResponse, TokenBidError, TokenOfferData, TokenOfferResponse, TokenOfferError, BuyTokensData, BuyTokensResponse, BuyTokensError, SellTokensData, SellTokensResponse, SellTokensError, WithdrawTokenBidData, WithdrawTokenBidResponse, WithdrawTokenBidError, WithdrawTokenOfferData, WithdrawTokenOfferResponse, WithdrawTokenOfferError, UpdateTokenBidWhitelistData, UpdateTokenBidWhitelistResponse, UpdateTokenBidWhitelistError, UpdateTokenOfferWhitelistData, UpdateTokenOfferWhitelistResponse, UpdateTokenOfferWhitelistError, UpdateTokenAdminWhitelistData, UpdateTokenAdminWhitelistResponse, UpdateTokenAdminWhitelistError } from './types.gen.js';
+import type { LaunchNftCollectionData, LaunchNftCollectionResponse, LaunchNftCollectionError, LaunchTokenData, LaunchTokenResponse, LaunchTokenError, GetContractInfoData, GetContractInfoResponse, GetContractInfoError, GetNftInfoData, GetNftInfoResponse, GetNftInfoError, GetNftV2InfoData, GetNftV2InfoResponse, GetNftV2InfoError, FaucetData, FaucetResponse2, FaucetError, GetTokenInfoData, GetTokenInfoResponse, GetTokenInfoError, GetTokenBalanceData, GetTokenBalanceResponse, GetTokenBalanceError, GetNonceData, GetNonceResponse, GetNonceError, GetTokenHoldersData, GetTokenHoldersResponse, GetTokenHoldersError, GetTransactionsData, GetTransactionsResponse, GetTransactionsError, ProveData, ProveResponse, ProveError, GetProofData, GetProofResponse, GetProofError, SendTransactionData, SendTransactionResponse, SendTransactionError, TxStatusData, TxStatusResponse, TxStatusError, MintTokensData, MintTokensResponse, MintTokensError, MintNftData, MintNftResponse, MintNftError, TransferNftData, TransferNftResponse, TransferNftError, ApproveNftData, ApproveNftResponse, ApproveNftError, SellNftData, SellNftResponse, SellNftError, BuyNftData, BuyNftResponse, BuyNftError, TransferTokensData, TransferTokensResponse, TransferTokensError, AirdropTokensData, AirdropTokensResponse, AirdropTokensError, RedeemTokensData, RedeemTokensResponse, RedeemTokensError, BurnTokensData, BurnTokensResponse, BurnTokensError, TokenBidData, TokenBidResponse, TokenBidError, TokenOfferData, TokenOfferResponse, TokenOfferError, BuyTokensData, BuyTokensResponse, BuyTokensError, SellTokensData, SellTokensResponse, SellTokensError, WithdrawTokenBidData, WithdrawTokenBidResponse, WithdrawTokenBidError, WithdrawTokenOfferData, WithdrawTokenOfferResponse, WithdrawTokenOfferError, UpdateTokenBidWhitelistData, UpdateTokenBidWhitelistResponse, UpdateTokenBidWhitelistError, UpdateTokenOfferWhitelistData, UpdateTokenOfferWhitelistResponse, UpdateTokenOfferWhitelistError, UpdateTokenAdminWhitelistData, UpdateTokenAdminWhitelistResponse, UpdateTokenAdminWhitelistError } from './types.gen.js';
 import { client as _heyApiClient } from './client.gen.js';
 
 export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean> = ClientOptions<TData, ThrowOnError> & {
@@ -215,6 +215,50 @@ export const getNonce = <ThrowOnError extends boolean = false>(options: Options<
     });
 };
 
+/**
+ * Retrieve the holders of a token
+ * The `holders` endpoint retrieves the holders of a token.
+ *
+ */
+export const getTokenHolders = <ThrowOnError extends boolean = false>(options: Options<GetTokenHoldersData, ThrowOnError>) => {
+    return (options.client ?? _heyApiClient).post<GetTokenHoldersResponse, GetTokenHoldersError, ThrowOnError>({
+        security: [
+            {
+                name: 'x-api-key',
+                type: 'apiKey'
+            }
+        ],
+        url: '/info/holders',
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options?.headers
+        }
+    });
+};
+
+/**
+ * Retrieve the transactions of a address
+ * The `transactions` endpoint retrieves the transactions of a address.
+ *
+ */
+export const getTransactions = <ThrowOnError extends boolean = false>(options: Options<GetTransactionsData, ThrowOnError>) => {
+    return (options.client ?? _heyApiClient).post<GetTransactionsResponse, GetTransactionsError, ThrowOnError>({
+        security: [
+            {
+                name: 'x-api-key',
+                type: 'apiKey'
+            }
+        ],
+        url: '/info/transactions',
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options?.headers
+        }
+    });
+};
+
 /**
  * Generate proofs for signed token transactions.
  * The `prove` endpoint initiates the proof generation process for a set of signed token transactions.

package/src/client/types.gen.ts

@@ -41,6 +41,21 @@ export type BalanceRequestParams = {
     address: string;
 };
 
+export type TransactionsListRequestParams = {
+    /**
+     * The address of the token contract (optional).
+     */
+    tokenAddress?: string;
+    /**
+     * The token ID (optional).
+     */
+    tokenId?: string;
+    /**
+     * The Mina address for which to retrieve the balance.
+     */
+    address: string;
+};
+
 export type BalanceResponse = {
     /**
      * The address of the token contract (optional).
@@ -86,6 +101,95 @@ export type NonceResponse = {
     hasAccount?: boolean;
 };
 
+export type TokenHolder = {
+    /**
+     * The address of the token holder
+     */
+    address: string;
+    /**
+     * The total token balance held by this address
+     */
+    balance: number;
+    /**
+     * The percentage of total token supply held by this address
+     */
+    percentage: number;
+    /**
+     * Whether this holder is a zkApp account
+     */
+    isZkappAccount: boolean;
+};
+
+export type TokenHoldersRequestParams = {
+    /**
+     * The Mina address for which to retrieve the holders
+     */
+    address: string;
+};
+
+export type TokenHoldersResponse = {
+    /**
+     * Array of token holders and their balances
+     */
+    holders: Array<TokenHolder>;
+};
+
+export type TransactionData = {
+    /**
+     * Timestamp of the transaction
+     */
+    timestamp: number;
+    /**
+     * Status of the transaction
+     */
+    status: string;
+    updatedAccounts: Array<{
+        /**
+         * Address of the updated account
+         */
+        accountAddress: string;
+        /**
+         * Whether this is a zkApp account
+         */
+        isZkappAccount: boolean;
+        /**
+         * Hash of the verification key
+         */
+        verificationKeyHash?: string;
+    }>;
+    /**
+     * Number of account updates in the transaction
+     */
+    accountUpdatesCount: number;
+    /**
+     * Address of the prover
+     */
+    proverAddress: string;
+    /**
+     * Whether this is a zkApp account
+     */
+    isZkappAccount: boolean;
+    /**
+     * Transaction hash
+     */
+    hash: string;
+    /**
+     * Transaction fee
+     */
+    fee: number;
+    /**
+     * Transaction memo
+     */
+    memo: string;
+};
+
+export type TransactionsListResponse = {
+    /**
+     * Array of transactions
+     */
+    transactions: Array<TransactionData>;
+};
+
 export type ErrorResponse = {
     /**
      * Error message detailing the issue.
@@ -2020,6 +2124,96 @@ export type GetNonceResponses = {
 
 export type GetNonceResponse = GetNonceResponses[keyof GetNonceResponses];
 
+export type GetTokenHoldersData = {
+    body: TokenHoldersRequestParams;
+    path?: never;
+    query?: never;
+    url: '/info/holders';
+};
+
+export type GetTokenHoldersErrors = {
+    /**
+     * Bad request - invalid input parameters.
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized - user not authenticated.
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden - user doesn't have permission.
+     */
+    403: ErrorResponse;
+    /**
+     * Too many requests.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error - something went wrong during the request.
+     */
+    500: ErrorResponse;
+    /**
+     * Service unavailable - blockchain or other external service is down.
+     */
+    503: ErrorResponse;
+};
+
+export type GetTokenHoldersError = GetTokenHoldersErrors[keyof GetTokenHoldersErrors];
+
+export type GetTokenHoldersResponses = {
+    /**
+     * Successful retrieval of token holders.
+     */
+    200: TokenHoldersResponse;
+};
+
+export type GetTokenHoldersResponse = GetTokenHoldersResponses[keyof GetTokenHoldersResponses];
+
+export type GetTransactionsData = {
+    body: TransactionsListRequestParams;
+    path?: never;
+    query?: never;
+    url: '/info/transactions';
+};
+
+export type GetTransactionsErrors = {
+    /**
+     * Bad request - invalid input parameters.
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized - user not authenticated.
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden - user doesn't have permission.
+     */
+    403: ErrorResponse;
+    /**
+     * Too many requests.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error - something went wrong during the request.
+     */
+    500: ErrorResponse;
+    /**
+     * Service unavailable - blockchain or other external service is down.
+     */
+    503: ErrorResponse;
+};
+
+export type GetTransactionsError = GetTransactionsErrors[keyof GetTransactionsErrors];
+
+export type GetTransactionsResponses = {
+    /**
+     * Successful retrieval of transactions.
+     */
+    200: TransactionsListResponse;
+};
+
+export type GetTransactionsResponse = GetTransactionsResponses[keyof GetTransactionsResponses];
+
 export type ProveData = {
     body: ProveTokenTransaction | ProveTokenTransactions | ProveNftTransaction | ProveNftTransactions;
     path?: never;