Merge pull request #74 from bridgesplit/staging

Staging

Author: Bhargavamacha

.github/workflows/tests.yml

@@ -5,9 +5,13 @@ on:
   pull_request:
     branches:
       - 'staging'
+
 jobs:
   setup-tests:
     runs-on: ubicloud-standard-16
+    concurrency:
+      group: ${{ github.workflow }}-${{ github.ref }}
+      cancel-in-progress: true
     steps:
       - id: cache-cli-deps
         uses: actions/cache@v2

clients/rwa-token-sdk/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@bridgesplit/rwa-token-sdk",
-    "version": "0.0.4",
+    "version": "0.0.15",
     "description": "RWA Token SDK for the development of permissioned tokens on SVM blockchains.",
     "homepage": "https://github.com/bridgesplit/rwa-token#readme",
     "main": "dist/index",

clients/rwa-token-sdk/src/asset-controller/instructions.ts

@@ -37,6 +37,7 @@ import {
 	getExtraMetasListPda,
 	getTrackerAccountPda,
 	assetControllerProgramId,
+	getAssetControllerEventAuthority,
 } from "./utils";
 import { type AnchorProvider, BN } from "@coral-xyz/anchor";
 
@@ -75,11 +76,52 @@ export async function getCreateAssetControllerIx(
 			systemProgram: SystemProgram.programId,
 			tokenProgram: TOKEN_2022_PROGRAM_ID,
 			authority: args.authority,
+			eventAuthority: getAssetControllerEventAuthority(),
+			program: assetControllerProgramId,
 		})
 		.instruction();
 	return ix;
 }
 
+/** Represents arguments for update an on chain asset metadata. */
+export type UpdateAssetMetadataArgs = {
+	authority: string;
+	name?: string;
+	uri?: string;
+	symbol?: string;
+  } & CommonArgs;
+
+/**
+ * Builds the transaction instruction to create an Asset Controller.
+ * @param args - {@link UpdateAssetMetadataArgs}
+ * @returns Create asset controller transaction instruction
+ */
+export async function getUpdateAssetMetadataIx(
+	args: UpdateAssetMetadataArgs,
+	provider: AnchorProvider
+): Promise<TransactionInstruction> {
+	const assetProgram = getAssetControllerProgram(provider);
+	const ix = await assetProgram.methods
+		.updateMetadata({
+			name: args.name || null,
+			uri: args.uri || null,
+			symbol: args.symbol || null,
+		})
+		.accountsStrict({
+			payer: args.payer,
+			assetMint: args.assetMint,
+			assetController: getAssetControllerPda(args.assetMint),
+			tokenProgram: TOKEN_2022_PROGRAM_ID,
+			authority: args.authority,
+			eventAuthority: getAssetControllerEventAuthority(),
+			systemProgram: SystemProgram.programId,
+			program: assetControllerProgramId,
+		})
+		.instruction();
+	return ix;
+}
+
+
 /** Represents arguments for issuing an on chain asset/token. */
 export type IssueTokenArgs = {
   amount: number;
@@ -311,6 +353,7 @@ export async function getSetupAssetControllerIxs(
 		updatedArgs,
 		provider
 	);
+
 	return {
 		ixs: [
 			assetControllerCreateIx,

clients/rwa-token-sdk/src/asset-controller/utils.ts

@@ -1,5 +1,5 @@
 import { PublicKey } from "@solana/web3.js";
-import { type Idl, Program, type Provider } from "@coral-xyz/anchor";
+import { type Idl, Program, type Provider, utils } from "@coral-xyz/anchor";
 import { AssetControllerIdl, AssetControllerIdlTypes } from "../programs";
 import { utf8 } from "@coral-xyz/anchor/dist/cjs/utils/bytes";
 
@@ -48,3 +48,8 @@ export const getTrackerAccountPda = (assetMint: string, owner: string) =>
 		[new PublicKey(assetMint).toBuffer(), new PublicKey(owner).toBuffer()],
 		assetControllerProgramId
 	)[0];
+
+export const getAssetControllerEventAuthority = () => PublicKey.findProgramAddressSync(
+	[utils.bytes.utf8.encode("__event_authority")],
+	assetControllerProgramId
+)[0];

clients/rwa-token-sdk/src/classes/AssetController.ts

@@ -11,6 +11,8 @@ import {
 	getAssetControllerPda,
 	getTrackerAccountPda,
 	getExtraMetasListPda,
+	getUpdateAssetMetadataIx,
+	UpdateAssetMetadataArgs,
 } from "../asset-controller";
 import { type IxReturn } from "../utils";
 import { type RwaClient } from "./Client";
@@ -41,6 +43,21 @@ export class AssetController {
 		return setupControllerIx;
 	}
 
+	/**
+	 * Update the asset controller's metadata.
+	 * @param - {@link UpdateAssetMetadataArgs}
+	 * @returns A Promise that resolves to the instructions to update the asset controller's metadata.
+	 * */
+	async updateAssetMetadata(
+		updateAssetControllerArgs: UpdateAssetMetadataArgs
+	): Promise<TransactionInstruction> {
+		const updateMetadataIx = await getUpdateAssetMetadataIx(
+			updateAssetControllerArgs,
+			this.rwaClient.provider
+		);
+		return updateMetadataIx;
+	}
+
 	/**
    * Asynchronously generates instructions to issue tokens.
    * @param - {@link IssueTokenArgs}

clients/rwa-token-sdk/src/classes/DataRegistry.ts

@@ -8,6 +8,8 @@ import {
 	getDelegateDataRegistryIx,
 	getUpdateDataAccountIx,
 	getDataRegistryPda,
+	DeleteDataAccountArgs,
+	getDeleteDataAccountIx,
 } from "../data-registry";
 import { type RwaClient } from "./Client";
 
@@ -49,6 +51,20 @@ export class DataRegistry {
 		return updateIx;
 	}
 
+	/**
+   * Asynchronously generates instructions to delete asset information.
+   * @returns A Promise that resolves to the instructions to delete asset information.
+   */
+	async deleteAssetsDataAccountInfoIxns(
+		deleteArgs: DeleteDataAccountArgs
+	): Promise<TransactionInstruction> {
+		const deleteIx = await getDeleteDataAccountIx(
+			deleteArgs,
+			this.rwaClient.provider
+		);
+		return deleteIx;
+	}
+
 	/**
    * Asynchronously generates instructions to update asset information.
    * @returns A Promise that resolves to the instructions to update asset information.

clients/rwa-token-sdk/src/data-registry/instructions.ts

@@ -102,6 +102,27 @@ export async function getUpdateDataAccountIx(
 	return ix;
 }
 
+export type DeleteDataAccountArgs = {
+	signer: string;
+	dataAccount: string;
+  } & CommonArgs;
+  
+export async function getDeleteDataAccountIx(
+	args: DeleteDataAccountArgs,
+	provider: AnchorProvider
+): Promise<TransactionInstruction> {
+	const dataProgram = getDataRegistryProgram(provider);
+	const ix = await dataProgram.methods
+		.deleteDataAccount()
+		.accountsStrict({
+			signer: args.signer,
+			dataAccount: args.dataAccount,
+			dataRegistry: getDataRegistryPda(args.assetMint),
+		})
+		.instruction();
+	return ix;
+}
+
 export type DelegateDataRegistryArgs = {
   delegate: string;
   authority: string;

clients/rwa-token-sdk/src/identity-registry/utils.ts

@@ -31,3 +31,5 @@ export const getIdentityAccountPda = (assetMint: string, owner: string) => Publi
 	[getIdentityRegistryPda(assetMint).toBuffer(), new PublicKey(owner).toBuffer()],
 	identityRegistryProgramId,
 )[0];
+
+export const POLICY_SKIP_LEVEL = 255;