feat: 🎸 support asset IDs as uuids

also return the assetId as `asset` in the response when creating an
asset

Author: polymath-eric

package.json

@@ -49,7 +49,7 @@
     "@polymeshassociation/fireblocks-signing-manager": "^2.5.0",
     "@polymeshassociation/hashicorp-vault-signing-manager": "^3.4.0",
     "@polymeshassociation/local-signing-manager": "^3.3.0",
-    "@polymeshassociation/polymesh-sdk": "26.0.0-beta.1",
+    "@polymeshassociation/polymesh-sdk": "^26.1.0",
     "@polymeshassociation/signing-manager-types": "^3.2.0",
     "class-transformer": "0.5.1",
     "class-validator": "^0.14.0",

src/assets/assets.controller.ts

@@ -10,6 +10,7 @@ import {
   ApiTags,
   ApiUnprocessableEntityResponse,
 } from '@nestjs/swagger';
+import { Asset } from '@polymeshassociation/polymesh-sdk/types';
 
 import { AssetsService } from '~/assets/assets.service';
 import { createAssetDetailsModel } from '~/assets/assets.util';
@@ -23,6 +24,7 @@ import { SetAssetDocumentsDto } from '~/assets/dto/set-asset-documents.dto';
 import { AgentOperationModel } from '~/assets/models/agent-operation.model';
 import { AssetDetailsModel } from '~/assets/models/asset-details.model';
 import { AssetDocumentModel } from '~/assets/models/asset-document.model';
+import { CreatedAssetModel } from '~/assets/models/created-asset.model';
 import { IdentityBalanceModel } from '~/assets/models/identity-balance.model';
 import { RequiredMediatorsModel } from '~/assets/models/required-mediators.model';
 import { authorizationRequestResolver } from '~/authorizations/authorizations.util';
@@ -33,7 +35,7 @@ import { TransactionBaseDto } from '~/common/dto/transaction-base-dto';
 import { TransferOwnershipDto } from '~/common/dto/transfer-ownership.dto';
 import { PaginatedResultsModel } from '~/common/models/paginated-results.model';
 import { TransactionQueueModel } from '~/common/models/transaction-queue.model';
-import { handleServiceResult, TransactionResponseModel } from '~/common/utils';
+import { handleServiceResult, TransactionResolver, TransactionResponseModel } from '~/common/utils';
 import { MetadataService } from '~/metadata/metadata.service';
 import { GlobalMetadataModel } from '~/metadata/models/global-metadata.model';
 
@@ -72,7 +74,7 @@ export class AssetsController {
     name: 'asset',
     description: 'The Asset (Ticker/Asset ID) whose details are to be fetched',
     type: 'string',
-    example: '0xa3616b82e8e1080aedc952ea28b9db8b',
+    example: '3616b82e-8e10-80ae-dc95-2ea28b9db8b3',
   })
   @ApiOkResponse({
     description: 'Basic details of the Asset',
@@ -94,7 +96,7 @@ export class AssetsController {
     name: 'asset',
     description: 'The Asset (Ticker/Asset ID) whose holders are to be fetched',
     type: 'string',
-    example: '0xa3616b82e8e1080aedc952ea28b9db8b',
+    example: '3616b82e-8e10-80ae-dc95-2ea28b9db8b3',
   })
   @ApiQuery({
     name: 'size',
@@ -146,7 +148,7 @@ export class AssetsController {
     name: 'asset',
     description: 'The Asset (Ticker/Asset ID) whose attached documents are to be fetched',
     type: 'string',
-    example: '0xa3616b82e8e1080aedc952ea28b9db8b',
+    example: '3616b82e-8e10-80ae-dc95-2ea28b9db8b3',
   })
   @ApiQuery({
     name: 'size',
@@ -203,7 +205,7 @@ export class AssetsController {
     name: 'asset',
     description: 'The Asset (Ticker/Asset ID) whose documents are to be updated',
     type: 'string',
-    example: '0xa3616b82e8e1080aedc952ea28b9db8b',
+    example: '3616b82e-8e10-80ae-dc95-2ea28b9db8b3',
   })
   @ApiOkResponse({
     description: 'Details of the transaction',
@@ -231,7 +233,7 @@ export class AssetsController {
     name: 'asset',
     description: 'The Asset (Ticker/Asset ID) to issue',
     type: 'string',
-    example: '0xa3616b82e8e1080aedc952ea28b9db8b',
+    example: '3616b82e-8e10-80ae-dc95-2ea28b9db8b3',
   })
   @ApiTransactionResponse({
     description: 'Details about the transaction',
@@ -266,7 +268,15 @@ export class AssetsController {
   @Post('create')
   public async createAsset(@Body() params: CreateAssetDto): Promise<TransactionResponseModel> {
     const result = await this.assetsService.createAsset(params);
-    return handleServiceResult(result);
+
+    const resolver: TransactionResolver<Asset> = ({ result: asset, transactions, details }) =>
+      new CreatedAssetModel({
+        asset,
+        transactions,
+        details,
+      });
+
+    return handleServiceResult(result, resolver);
   }
 
   @ApiOperation({
@@ -278,7 +288,7 @@ export class AssetsController {
     name: 'asset',
     description: 'The Asset (Ticker/Asset ID) whose ownership is to be transferred',
     type: 'string',
-    example: '0xa3616b82e8e1080aedc952ea28b9db8b',
+    example: '3616b82e-8e10-80ae-dc95-2ea28b9db8b3',
   })
   @ApiTransactionResponse({
     description: 'Newly created Authorization Request along with transaction details',
@@ -329,7 +339,7 @@ export class AssetsController {
     name: 'asset',
     description: 'The Asset (Ticker/Asset ID) to freeze',
     type: 'string',
-    example: '0xa3616b82e8e1080aedc952ea28b9db8b',
+    example: '3616b82e-8e10-80ae-dc95-2ea28b9db8b3',
   })
   @ApiTransactionResponse({
     description: 'Details about the transaction',
@@ -360,7 +370,7 @@ export class AssetsController {
     name: 'asset',
     description: 'The Asset (Ticker/Asset ID) to unfreeze',
     type: 'string',
-    example: '0xa3616b82e8e1080aedc952ea28b9db8b',
+    example: '3616b82e-8e10-80ae-dc95-2ea28b9db8b3',
   })
   @ApiTransactionResponse({
     description: 'Details about the transaction',
@@ -390,7 +400,7 @@ export class AssetsController {
     name: 'asset',
     description: 'The Asset (Ticker/Asset ID) to be transferred',
     type: 'string',
-    example: '0xa3616b82e8e1080aedc952ea28b9db8b',
+    example: '3616b82e-8e10-80ae-dc95-2ea28b9db8b3',
   })
   @ApiTransactionResponse({
     description: 'Details about the transaction',
@@ -420,7 +430,7 @@ export class AssetsController {
     name: 'asset',
     description: 'The Asset (Ticker/Asset ID) whose operation history is to be fetched',
     type: 'string',
-    example: '0xa3616b82e8e1080aedc952ea28b9db8b',
+    example: '3616b82e-8e10-80ae-dc95-2ea28b9db8b3',
   })
   @ApiOkResponse({
     description: 'List of operations grouped by the agent Identity who performed them',
@@ -445,7 +455,7 @@ export class AssetsController {
     name: 'asset',
     description: 'The Asset (Ticker/Asset ID) whose required mediators is to be fetched',
     type: 'string',
-    example: '0xa3616b82e8e1080aedc952ea28b9db8b',
+    example: '3616b82e-8e10-80ae-dc95-2ea28b9db8b3',
   })
   @ApiOkResponse({
     description: 'The required mediators for the asset',
@@ -470,7 +480,7 @@ export class AssetsController {
     name: 'asset',
     description: 'The Asset (Ticker/Asset ID) to set required mediators for',
     type: 'string',
-    example: '0xa3616b82e8e1080aedc952ea28b9db8b',
+    example: '3616b82e-8e10-80ae-dc95-2ea28b9db8b3',
   })
   @ApiTransactionResponse({
     description: 'Details about the transaction',
@@ -496,7 +506,7 @@ export class AssetsController {
     name: 'asset',
     description: 'The Asset (Ticker/Asset ID) to set required mediators for',
     type: 'string',
-    example: '0xa3616b82e8e1080aedc952ea28b9db8b',
+    example: '3616b82e-8e10-80ae-dc95-2ea28b9db8b3',
   })
   @ApiTransactionResponse({
     description: 'Details about the transaction',
@@ -522,7 +532,7 @@ export class AssetsController {
     name: 'asset',
     description: 'The Asset (Ticker/Asset ID) to pre-approve',
     type: 'string',
-    example: '0xa3616b82e8e1080aedc952ea28b9db8b',
+    example: '3616b82e-8e10-80ae-dc95-2ea28b9db8b3',
   })
   @ApiTransactionResponse({
     description: 'Details about the transaction',
@@ -552,7 +562,7 @@ export class AssetsController {
     name: 'asset',
     description: 'The Asset (Ticker/Asset ID) to remove pre-approval for',
     type: 'string',
-    example: '0xa3616b82e8e1080aedc952ea28b9db8b',
+    example: '3616b82e-8e10-80ae-dc95-2ea28b9db8b3',
   })
   @ApiTransactionResponse({
     description: 'Details about the transaction',

src/assets/models/created-asset.model.ts

@@ -0,0 +1,23 @@
+/* istanbul ignore file */
+
+import { ApiPropertyOptional } from '@nestjs/swagger';
+import { Asset } from '@polymeshassociation/polymesh-sdk/types';
+
+import { FromEntity } from '~/common/decorators/transformation';
+import { TransactionQueueModel } from '~/common/models/transaction-queue.model';
+
+export class CreatedAssetModel extends TransactionQueueModel {
+  @ApiPropertyOptional({
+    description: 'The newly created Asset ID',
+    example: '3616b82e-8e10-80ae-dc95-2ea28b9db8b3',
+  })
+  @FromEntity()
+  readonly asset: Asset;
+
+  constructor(model: CreatedAssetModel) {
+    const { transactions, details, ...rest } = model;
+    super({ transactions, details });
+
+    Object.assign(this, rest);
+  }
+}

src/checkpoints/checkpoints.controller.ts

@@ -57,7 +57,7 @@ export class CheckpointsController {
     name: 'asset',
     description: 'The Asset (Ticker/Asset ID) whose attached Checkpoints are to be fetched',
     type: 'string',
-    example: '0xa3616b82e8e1080aedc952ea28b9db8b',
+    example: '3616b82e-8e10-80ae-dc95-2ea28b9db8b3',
   })
   @ApiQuery({
     name: 'size',
@@ -112,7 +112,7 @@ export class CheckpointsController {
     name: 'asset',
     description: 'The Asset (Ticker/Asset ID) whose Checkpoint is to be fetched',
     type: 'string',
-    example: '0xa3616b82e8e1080aedc952ea28b9db8b',
+    example: '3616b82e-8e10-80ae-dc95-2ea28b9db8b3',
   })
   @ApiParam({
     name: 'id',
@@ -148,7 +148,7 @@ export class CheckpointsController {
     name: 'asset',
     description: 'The Asset (Ticker/Asset ID) for which the Checkpoint is to be created',
     type: 'string',
-    example: '0xa3616b82e8e1080aedc952ea28b9db8b',
+    example: '3616b82e-8e10-80ae-dc95-2ea28b9db8b3',
   })
   @ApiTransactionResponse({
     description: 'Details of the newly created Checkpoint',
@@ -185,7 +185,7 @@ export class CheckpointsController {
     description:
       'The Asset (Ticker/Asset ID) whose attached Checkpoint Schedules are to be fetched',
     type: 'string',
-    example: '0xa3616b82e8e1080aedc952ea28b9db8b',
+    example: '3616b82e-8e10-80ae-dc95-2ea28b9db8b3',
   })
   @ApiArrayResponse(CheckpointScheduleModel, {
     description: 'List of active Schedules which create Checkpoints for a specific Asset',
@@ -217,7 +217,7 @@ export class CheckpointsController {
     name: 'asset',
     description: 'The Asset (Ticker/Asset ID) whose Checkpoint Schedule is to be fetched',
     type: 'string',
-    example: '0xa3616b82e8e1080aedc952ea28b9db8b',
+    example: '3616b82e-8e10-80ae-dc95-2ea28b9db8b3',
   })
   @ApiParam({
     name: 'id',
@@ -258,7 +258,7 @@ export class CheckpointsController {
     name: 'asset',
     description: 'The Asset (Ticker/Asset ID) for which the Checkpoint creation is to be scheduled',
     type: 'string',
-    example: '0xa3616b82e8e1080aedc952ea28b9db8b',
+    example: '3616b82e-8e10-80ae-dc95-2ea28b9db8b3',
   })
   @ApiTransactionResponse({
     description: 'Details of the newly created Checkpoint Schedule',
@@ -309,7 +309,7 @@ export class CheckpointsController {
     name: 'asset',
     description: 'The Asset (Ticker/Asset ID) for which to fetch holder balances',
     type: 'string',
-    example: '0xa3616b82e8e1080aedc952ea28b9db8b',
+    example: '3616b82e-8e10-80ae-dc95-2ea28b9db8b3',
   })
   @ApiParam({
     name: 'id',
@@ -401,7 +401,7 @@ export class CheckpointsController {
     name: 'asset',
     description: 'The Asset (Ticker/Asset ID) for which the Schedule is to be deleted',
     type: 'string',
-    example: '0xa3616b82e8e1080aedc952ea28b9db8b',
+    example: '3616b82e-8e10-80ae-dc95-2ea28b9db8b3',
   })
   @ApiParam({
     name: 'id',
@@ -437,7 +437,7 @@ export class CheckpointsController {
     name: 'asset',
     description: 'The Asset (Ticker/Asset ID) whose Checkpoints are to be fetched',
     type: 'string',
-    example: '0xa3616b82e8e1080aedc952ea28b9db8b',
+    example: '3616b82e-8e10-80ae-dc95-2ea28b9db8b3',
   })
   @ApiParam({
     name: 'scheduleId',
@@ -474,7 +474,7 @@ export class CheckpointsController {
     name: 'asset',
     description: 'The Asset (Ticker/Asset ID) for which Schedule complexity is to be fetched',
     type: 'string',
-    example: '0xa3616b82e8e1080aedc952ea28b9db8b',
+    example: '3616b82e-8e10-80ae-dc95-2ea28b9db8b3',
   })
   @ApiNotFoundResponse({
     description: 'The Asset was not found',
@@ -506,7 +506,7 @@ export class CheckpointsController {
     name: 'asset',
     description: 'The Asset (Ticker/Asset ID) whose Checkpoint Schedule is to be fetched',
     type: 'string',
-    example: '0xa3616b82e8e1080aedc952ea28b9db8b',
+    example: '3616b82e-8e10-80ae-dc95-2ea28b9db8b3',
   })
   @ApiParam({
     name: 'id',

src/checkpoints/models/checkpoint-schedule.model.ts

@@ -17,7 +17,7 @@ export class CheckpointScheduleModel {
   @ApiProperty({
     description: 'The Asset (Asset ID/Ticker) whose Checkpoints will be created with this Schedule',
     type: 'string',
-    example: '0xa3616b82e8e1080aedc952ea28b9db8b',
+    example: '3616b82e-8e10-80ae-dc95-2ea28b9db8b3',
   })
   readonly asset: string;
 

src/common/decorators/validation.ts

@@ -3,6 +3,7 @@
 /* eslint-disable @typescript-eslint/explicit-function-return-type */
 import { applyDecorators } from '@nestjs/common';
 import { BigNumber } from '@polymeshassociation/polymesh-sdk';
+import { isHexUuid, isUuid } from '@polymeshassociation/polymesh-sdk/utils';
 import {
   IsHexadecimal,
   IsUppercase,
@@ -42,9 +43,8 @@ export function IsTicker(validationOptions?: ValidationOptions) {
   );
 }
 
-const assetIdRegex = /0x[0-9a-fA-F]{32}/;
 export const isAssetId = (id: string): boolean => {
-  return assetIdRegex.test(id);
+  return isHexUuid(id) || isUuid(id);
 };
 
 export function IsAsset(validationOptions?: ValidationOptions) {

src/common/models/extrinsic.model.ts

@@ -64,7 +64,7 @@ export class ExtrinsicModel {
     example: [
       {
         name: 'asset',
-        value: '0xa3616b82e8e1080aedc952ea28b9db8b',
+        value: '3616b82e-8e10-80ae-dc95-2ea28b9db8b3',
       },
     ],
   })