@solana/accounts - npm Package Compare versions

Comparing version 2.0.0-experimental.7297b81 to 2.0.0-experimental.76ad167

dist/index.browser.js

@@ -19,2 +19,17 @@ import { getBase64Encoder, getBase58Encoder } from '@solana/codecs-strings';
 }
+function accountExists(account) {
+  return !("exists" in account) || "exists" in account && account.exists;
+}
+function assertAccountDecoded(account) {
+  if (accountExists(account) && account.data instanceof Uint8Array) {
+    throw new Error(`Expected account [${account.address}] to be decoded.`);
+  }
+}
+function assertAccountsDecoded(accounts) {
+  const encoded = accounts.filter((a) => accountExists(a) && a.data instanceof Uint8Array);
+  if (encoded.length > 0) {
+    const encodedAddresses = encoded.map((a) => a.address).join(", ");
+    throw new Error(`Expected accounts [${encodedAddresses}] to be decoded.`);
+  }
+}
 function parseBase64RpcAccount(address, rpcAccount) {
@@ -76,5 +91,12 @@ if (!rpcAccount)
 }
+function assertAccountsExist(accounts) {
+  const missingAccounts = accounts.filter((a) => !a.exists);
+  if (missingAccounts.length > 0) {
+    const missingAddresses = missingAccounts.map((a) => a.address);
+    throw new Error(`Expected accounts [${missingAddresses.join(", ")}] to exist.`);
+  }
+}
 
-export { BASE_ACCOUNT_SIZE, assertAccountExists, decodeAccount, fetchEncodedAccount, fetchEncodedAccounts, fetchJsonParsedAccount, fetchJsonParsedAccounts, parseBase58RpcAccount, parseBase64RpcAccount, parseJsonRpcAccount };
+export { BASE_ACCOUNT_SIZE, assertAccountDecoded, assertAccountExists, assertAccountsDecoded, assertAccountsExist, decodeAccount, fetchEncodedAccount, fetchEncodedAccounts, fetchJsonParsedAccount, fetchJsonParsedAccounts, parseBase58RpcAccount, parseBase64RpcAccount, parseJsonRpcAccount };
 //# sourceMappingURL=out.js.map
 //# sourceMappingURL=index.browser.js.map

dist/index.native.js

@@ -19,2 +19,17 @@ import { getBase64Encoder, getBase58Encoder } from '@solana/codecs-strings';
 }
+function accountExists(account) {
+  return !("exists" in account) || "exists" in account && account.exists;
+}
+function assertAccountDecoded(account) {
+  if (accountExists(account) && account.data instanceof Uint8Array) {
+    throw new Error(`Expected account [${account.address}] to be decoded.`);
+  }
+}
+function assertAccountsDecoded(accounts) {
+  const encoded = accounts.filter((a) => accountExists(a) && a.data instanceof Uint8Array);
+  if (encoded.length > 0) {
+    const encodedAddresses = encoded.map((a) => a.address).join(", ");
+    throw new Error(`Expected accounts [${encodedAddresses}] to be decoded.`);
+  }
+}
 function parseBase64RpcAccount(address, rpcAccount) {
@@ -76,5 +91,12 @@ if (!rpcAccount)
 }
+function assertAccountsExist(accounts) {
+  const missingAccounts = accounts.filter((a) => !a.exists);
+  if (missingAccounts.length > 0) {
+    const missingAddresses = missingAccounts.map((a) => a.address);
+    throw new Error(`Expected accounts [${missingAddresses.join(", ")}] to exist.`);
+  }
+}
 
-export { BASE_ACCOUNT_SIZE, assertAccountExists, decodeAccount, fetchEncodedAccount, fetchEncodedAccounts, fetchJsonParsedAccount, fetchJsonParsedAccounts, parseBase58RpcAccount, parseBase64RpcAccount, parseJsonRpcAccount };
+export { BASE_ACCOUNT_SIZE, assertAccountDecoded, assertAccountExists, assertAccountsDecoded, assertAccountsExist, decodeAccount, fetchEncodedAccount, fetchEncodedAccounts, fetchJsonParsedAccount, fetchJsonParsedAccounts, parseBase58RpcAccount, parseBase64RpcAccount, parseJsonRpcAccount };
 //# sourceMappingURL=out.js.map
 //# sourceMappingURL=index.native.js.map

dist/index.node.js

@@ -19,2 +19,17 @@ import { getBase64Encoder, getBase58Encoder } from '@solana/codecs-strings';
 }
+function accountExists(account) {
+  return !("exists" in account) || "exists" in account && account.exists;
+}
+function assertAccountDecoded(account) {
+  if (accountExists(account) && account.data instanceof Uint8Array) {
+    throw new Error(`Expected account [${account.address}] to be decoded.`);
+  }
+}
+function assertAccountsDecoded(accounts) {
+  const encoded = accounts.filter((a) => accountExists(a) && a.data instanceof Uint8Array);
+  if (encoded.length > 0) {
+    const encodedAddresses = encoded.map((a) => a.address).join(", ");
+    throw new Error(`Expected accounts [${encodedAddresses}] to be decoded.`);
+  }
+}
 function parseBase64RpcAccount(address, rpcAccount) {
@@ -76,5 +91,12 @@ if (!rpcAccount)
 }
+function assertAccountsExist(accounts) {
+  const missingAccounts = accounts.filter((a) => !a.exists);
+  if (missingAccounts.length > 0) {
+    const missingAddresses = missingAccounts.map((a) => a.address);
+    throw new Error(`Expected accounts [${missingAddresses.join(", ")}] to exist.`);
+  }
+}
 
-export { BASE_ACCOUNT_SIZE, assertAccountExists, decodeAccount, fetchEncodedAccount, fetchEncodedAccounts, fetchJsonParsedAccount, fetchJsonParsedAccounts, parseBase58RpcAccount, parseBase64RpcAccount, parseJsonRpcAccount };
+export { BASE_ACCOUNT_SIZE, assertAccountDecoded, assertAccountExists, assertAccountsDecoded, assertAccountsExist, decodeAccount, fetchEncodedAccount, fetchEncodedAccounts, fetchJsonParsedAccount, fetchJsonParsedAccounts, parseBase58RpcAccount, parseBase64RpcAccount, parseJsonRpcAccount };
 //# sourceMappingURL=out.js.map
 //# sourceMappingURL=index.node.js.map

dist/types/decode-account.d.ts

@@ -7,2 +7,8 @@ import type { Decoder } from '@solana/codecs-core';
 export declare function decodeAccount<TData extends object, TAddress extends string = string>(encodedAccount: MaybeEncodedAccount<TAddress>, decoder: Decoder<TData>): MaybeAccount<TData, TAddress>;
+/** Asserts that an account has been decoded. */
+export declare function assertAccountDecoded<TData extends object, TAddress extends string = string>(account: Account<TData | Uint8Array, TAddress>): asserts account is Account<TData, TAddress>;
+export declare function assertAccountDecoded<TData extends object, TAddress extends string = string>(account: MaybeAccount<TData | Uint8Array, TAddress>): asserts account is MaybeAccount<TData, TAddress>;
+/** Asserts that all accounts have been decoded. */
+export declare function assertAccountsDecoded<TData extends object, TAddress extends string = string>(accounts: Account<TData | Uint8Array, TAddress>[]): asserts accounts is Account<TData, TAddress>[];
+export declare function assertAccountsDecoded<TData extends object, TAddress extends string = string>(accounts: MaybeAccount<TData | Uint8Array, TAddress>[]): asserts accounts is MaybeAccount<TData, TAddress>[];
 //# sourceMappingURL=decode-account.d.ts.map

dist/types/fetch-account.d.ts

 import type { Address } from '@solana/addresses';
-import type { Slot } from '@solana/rpc-core/dist/types/rpc-methods/common';
-import type { GetAccountInfoApi } from '@solana/rpc-core/dist/types/rpc-methods/getAccountInfo';
-import type { GetMultipleAccountsApi } from '@solana/rpc-core/dist/types/rpc-methods/getMultipleAccounts';
-import type { Rpc } from '@solana/rpc-transport/dist/types/json-rpc-types';
-import type { Commitment } from '@solana/rpc-types';
+import type { Commitment, Rpc, Slot } from '@solana/rpc-types';
 import type { MaybeAccount, MaybeEncodedAccount } from './maybe-account.js';
+import type { GetAccountInfoApi, GetMultipleAccountsApi } from './rpc-api/index.js';
 /** Optional configuration for fetching a singular account. */
@@ -9,0 +6,0 @@ export type FetchAccountConfig = {

dist/types/maybe-account.d.ts

@@ -16,2 +16,6 @@ import { Address } from '@solana/addresses';
 };
+/** Asserts that all accounts that may or may not exist, actually all exist. */
+export declare function assertAccountsExist<TData extends object | Uint8Array, TAddress extends string = string>(accounts: MaybeAccount<TData, TAddress>[]): asserts accounts is (Account<TData, TAddress> & {
+    exists: true;
+})[];
 //# sourceMappingURL=maybe-account.d.ts.map

dist/types/parse-account.d.ts

 import type { Address } from '@solana/addresses';
-import type { AccountInfoBase, AccountInfoWithBase58Bytes, AccountInfoWithBase58EncodedData, AccountInfoWithBase64EncodedData } from '@solana/rpc-core/dist/types/rpc-methods/common';
 import type { Account, EncodedAccount } from './account.js';
 import { MaybeAccount, MaybeEncodedAccount } from './maybe-account.js';
+import type { AccountInfoBase, AccountInfoWithBase58Bytes, AccountInfoWithBase58EncodedData, AccountInfoWithBase64EncodedData, JsonParsedDataResponse } from './rpc-api/index.js';
 type Base64EncodedRpcAccount = AccountInfoBase & AccountInfoWithBase64EncodedData;
@@ -14,9 +14,4 @@ /** Parse an account object received from a base64-encoded RPC call into an EncodedAccount or MaybeEncodedAccount type. */
 type JsonParsedRpcAccount = AccountInfoBase & {
-    readonly data: JsonParsedData<unknown>;
+    readonly data: JsonParsedDataResponse<unknown>;
 };
-type JsonParsedData<TData> = {
-    readonly parsed: {
-        readonly info: TData;
-    };
-};
 /** Parse an account object received from a json-parsed RPC call into an Account or MaybeAccount type. */
@@ -23,0 +18,0 @@ export declare function parseJsonRpcAccount<TData extends object, TAddress extends string = string>(address: Address<TAddress>, rpcAccount: JsonParsedRpcAccount): Account<TData, TAddress>;

package.json

 {
   "name": "@solana/accounts",
-  "version": "2.0.0-experimental.7297b81",
+  "version": "2.0.0-experimental.76ad167",
   "description": "Helpers for representing, fetching and decoding Solana accounts",
@@ -49,8 +49,6 @@ "exports": {
   "dependencies": {
-    "@solana/addresses": "2.0.0-experimental.7297b81",
-    "@solana/codecs-core": "2.0.0-experimental.7297b81",
-    "@solana/codecs-strings": "2.0.0-experimental.7297b81",
-    "@solana/rpc-core": "2.0.0-experimental.7297b81",
-    "@solana/rpc-transport": "2.0.0-experimental.7297b81",
-    "@solana/rpc-types": "2.0.0-experimental.7297b81"
+    "@solana/addresses": "2.0.0-experimental.76ad167",
+    "@solana/codecs-core": "2.0.0-experimental.76ad167",
+    "@solana/codecs-strings": "2.0.0-experimental.76ad167",
+    "@solana/rpc-types": "2.0.0-experimental.76ad167"
   },
@@ -57,0 +55,0 @@ "devDependencies": {

README.md

@@ -150,2 +150,17 @@ [![npm][npm-image]][npm-url]
 
+### `assertAccountsExist()`
+
+Given an array of `MaybeAccount`s, this function asserts that all the accounts
+exist and allows them to be used as an array of `Account`s going forward.
+
+```ts
+const myAccounts: MaybeEncodedAccount<Address>[];
+assertAccountsExist(myAccounts);
+
+// Now we can use them as an array of accounts
+for (const a of myAccounts) {
+  a satisfies EncodedAccount<Address>;
+}
+```
+
 ### `parseBase64RpcAccount()`
@@ -256,1 +271,45 @@
 ```
+
+### `assertAccountDecoded()`
+
+This function asserts that an account stores decoded data, ie not a Uint8Array. Note that it does not check the shape of the data matches the decoded type, only that it is not a Uint8Array.
+
+```ts
+type MyAccountData = { name: string; age: number };
+
+const myAccount: Account<MyAccountData | Uint8Array, '1234..5678'>;
+assertAccountDecoded(myAccount);
+
+// now the account data can be used as MyAccountData
+account.data satisfies MyAccountData;
+```
+
+This is particularly useful for narrowing the result of fetching a JSON parsed account.
+
+
+```ts
+    const account: MaybeAccount<MockData | Uint8Array> = await fetchJsonParsedAccount<MockData>(
+        rpc, 
+        '1234..5678' as Address,
+    )
+
+    assertAccountDecoded(account);
+    // now we have a MaybeAccount<MockData>
+    account satisfies MaybeAccount<MockData>
+```
+
+### `assertAccountsDecoded`
+
+This function asserts that all input accounts store decoded data, ie not a Uint8Array. As with `assertAccountDecoded` it does not check the shape of the data matches the decoded type, only that it is not a Uint8Array.
+
+```ts
+type MyAccountData = { name: string; age: number };
+
+const myAccounts: Account<MyAccountData | Uint8Array, Address>[];
+assertAccountsDecoded(myAccounts);
+
+// now the account data can be used as MyAccountData
+for(const a of account) {
+    account.data satisfies MyAccountData;
+}
+```

New alerts

License Policy Violation

License

This package is not allowed per your license policy. Review the package's license to ensure compliance.

Found 1 instance in 1 package

Fixed alerts

License Policy Violation

License

This package is not allowed per your license policy. Review the package's license to ensure compliance.

Found 1 instance in 1 package

Improved metrics

Total package byte prevSize

161708

increased by28.82%

Dependency count

4

decreased by-33.33%

Number of package files

34

increased by30.77%

Lines of code

856

increased by45.08%

Number of lines in readme file

314

increased by23.14%

Dependency changes

• + Added@solana/addresses@2.0.0-experimental.76ad167(transitive)

• + Added@solana/assertions@2.0.0-experimental.76ad167(transitive)

• + Added@solana/codecs-core@2.0.0-experimental.76ad167(transitive)

• + Added@solana/codecs-numbers@2.0.0-experimental.76ad167(transitive)

• + Added@solana/codecs-strings@2.0.0-experimental.76ad167(transitive)

• + Added@solana/rpc-types@2.0.0-experimental.76ad167(transitive)

• - Removed@solana/rpc-core@2.0.0-experimental.7297b81

• - Removed@solana/rpc-transport@2.0.0-experimental.7297b81

• - Removed@solana/addresses@2.0.0-experimental.7297b81(transitive)

• - Removed@solana/assertions@2.0.0-experimental.7297b81(transitive)

• - Removed@solana/codecs-core@2.0.0-experimental.7297b81(transitive)

• - Removed@solana/codecs-numbers@2.0.0-experimental.7297b81(transitive)

• - Removed@solana/codecs-strings@2.0.0-experimental.7297b81(transitive)

• - Removed@solana/rpc-core@2.0.0-experimental.7297b81(transitive)

• - Removed@solana/rpc-transport@2.0.0-experimental.7297b81(transitive)

• - Removed@solana/rpc-types@2.0.0-experimental.7297b81(transitive)

• - Removedws@8.18.0(transitive)

• Updated@solana/addresses@2.0.0-experimental.76ad167

• Updated@solana/codecs-core@2.0.0-experimental.76ad167

• Updated@solana/codecs-strings@2.0.0-experimental.76ad167

• Updated@solana/rpc-types@2.0.0-experimental.76ad167