Suppoort attachments in the protocol (#299)

* Support attachments in the sdk

Author: Kolezhniuk

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@0xpolygonid/js-sdk",
-  "version": "1.32.5",
+  "version": "1.33.0",
   "description": "SDK to work with Polygon ID",
   "source": "./src/index.ts",
   "exports": {

package.json

@@ -10,7 +10,8 @@ import {
   IPackageManager,
   JWSPackerParams,
   ZeroKnowledgeProofRequest,
-  JSONObject
+  JSONObject,
+  Attachment
 } from '../types';
 import { DID, getUnixTimestamp } from '@iden3/js-iden3-core';
 import { proving } from '@iden3/js-jwz';
@@ -35,6 +36,7 @@ export type AuthorizationRequestCreateOptions = {
   accept?: string[];
   scope?: ZeroKnowledgeProofRequest[];
   expires_time?: Date;
+  attachments?: Attachment[];
 };
 
 /**
@@ -84,7 +86,8 @@ export function createAuthorizationRequestWithMessage(
       scope: opts?.scope ?? []
     },
     created_time: getUnixTimestamp(new Date()),
-    expires_time: opts?.expires_time ? getUnixTimestamp(opts.expires_time) : undefined
+    expires_time: opts?.expires_time ? getUnixTimestamp(opts.expires_time) : undefined,
+    attachments: opts?.attachments
   };
   return request;
 }

src/iden3comm/handlers/auth.ts

@@ -1,5 +1,6 @@
 import { PROTOCOL_MESSAGE_TYPE, MediaType } from '../constants';
 import {
+  Attachment,
   BasicMessage,
   CredentialOffer,
   CredentialsOfferMessage,
@@ -13,9 +14,9 @@ import * as uuid from 'uuid';
 import { proving } from '@iden3/js-jwz';
 import {
   Proposal,
-  ProposalRequestCredential,
   ProposalRequestMessage,
-  ProposalMessage
+  ProposalMessage,
+  ProposalRequestCredential
 } from '../types/protocol/proposal-request';
 import { IIdentityWallet } from '../../identity';
 import { byteEncoder } from '../../utils';
@@ -32,6 +33,7 @@ export type ProposalRequestCreationOptions = {
   credentials: ProposalRequestCredential[];
   did_doc?: DIDDocument;
   expires_time?: Date;
+  attachments?: Attachment[];
 };
 
 /** @beta ProposalCreationOptions represents proposal creation options */
@@ -62,7 +64,8 @@ export function createProposalRequest(
     type: PROTOCOL_MESSAGE_TYPE.PROPOSAL_REQUEST_MESSAGE_TYPE,
     body: opts,
     created_time: getUnixTimestamp(new Date()),
-    expires_time: opts?.expires_time ? getUnixTimestamp(opts.expires_time) : undefined
+    expires_time: opts?.expires_time ? getUnixTimestamp(opts.expires_time) : undefined,
+    attachments: opts.attachments
   };
   return request;
 }
@@ -153,7 +156,11 @@ export type ProposalHandlerOptions = BasicHandlerOptions & {
 /** @beta CredentialProposalHandlerParams represents credential proposal handler params */
 export type CredentialProposalHandlerParams = {
   agentUrl: string;
-  proposalResolverFn: (context: string, type: string) => Promise<Proposal>;
+  proposalResolverFn: (
+    context: string,
+    type: string,
+    opts?: { msg?: BasicMessage }
+  ) => Promise<Proposal>;
   packerParams: PackerParams;
 };
 
@@ -281,7 +288,9 @@ export class CredentialProposalHandler
       }
 
       // credential not found in the wallet, prepare proposal protocol message
-      const proposal = await this._params.proposalResolverFn(cred.context, cred.type);
+      const proposal = await this._params.proposalResolverFn(cred.context, cred.type, {
+        msg: proposalRequest
+      });
       if (!proposal) {
         throw new Error(`can't resolve Proposal for type: ${cred.type}, context: ${cred.context}`);
       }

src/iden3comm/handlers/credential-proposal.ts

@@ -10,6 +10,8 @@ export * from './protocol/accept-profile';
 export * from './protocol/discovery-protocol';
 export * from './protocol/problem-report';
 
+export * from './protocol/attachment';
+export * from './protocol/common';
 export * from './packer';
 export * from './models';
 export * from './packageManager';

src/iden3comm/types/index.ts

@@ -5,6 +5,7 @@ import { CircuitId } from '../../circuits';
 import { MediaType, PROTOCOL_MESSAGE_TYPE } from '../constants';
 import { DIDDocument, VerificationMethod } from 'did-resolver';
 import { StateVerificationOpts } from './models';
+import { Attachment } from './protocol/attachment';
 
 /**
  *  Protocol message type
@@ -51,14 +52,19 @@ export type BasicMessage = {
   to?: string;
   created_time?: number;
   expires_time?: number;
+  attachments?: Attachment[];
 };
 
 /**
  * Basic message with all possible fields required
  */
-export type RequiredBasicMessage = Omit<Required<BasicMessage>, 'created_time' | 'expires_time'> & {
+export type RequiredBasicMessage = Omit<
+  Required<BasicMessage>,
+  'created_time' | 'expires_time' | 'attachments'
+> & {
   created_time?: number;
   expires_time?: number;
+  attachments?: Attachment[];
 };
 
 /**

src/iden3comm/types/packer.ts

@@ -0,0 +1,12 @@
+import { JsonDocumentObject } from '../packer';
+
+export type Attachment = {
+  id: string;
+  description?: string;
+  media_type?: string;
+  data: AttachData;
+};
+
+export type AttachData = {
+  json: JsonDocumentObject;
+};

src/iden3comm/types/protocol/attachment.ts

@@ -0,0 +1,10 @@
+/**
+ * Represents information about a credential schema.
+ *
+ * @property {string} type - The type of the credential schema.
+ * @property {string} context - The context in which the credential schema is used.
+ */
+export type CredentialSchemaInfo = {
+  type: string;
+  context: string;
+};

src/iden3comm/types/protocol/common.ts

@@ -6,6 +6,7 @@ import {
   SupportedPaymentProofType
 } from '../../../verifiable';
 import { PROTOCOL_MESSAGE_TYPE } from '../../constants';
+import { CredentialSchemaInfo } from './common';
 
 /** @beta PaymentRequestMessage is struct the represents payment-request message */
 export type PaymentRequestMessage = BasicMessage & {
@@ -23,10 +24,7 @@ export type PaymentRequestMessageBody = {
 
 /** @beta PaymentRequestInfo is struct the represents payment info for payment-request */
 export type PaymentRequestInfo = {
-  credentials: {
-    type: string;
-    context: string;
-  }[];
+  credentials: CredentialSchemaInfo[];
   data:
     | Iden3PaymentRequestCryptoV1
     | (

src/iden3comm/types/protocol/payment.ts

@@ -1,16 +1,19 @@
-import { BasicMessage, DIDDocument, JsonDocumentObject } from '../';
+import { BasicMessage, DIDDocument } from '../';
 import { PROTOCOL_MESSAGE_TYPE } from '../../constants';
+import { CredentialSchemaInfo } from './common';
 
 /** @beta ProposalRequestMessage is struct the represents proposal-request message */
 export type ProposalRequestMessage = BasicMessage & {
   body: ProposalRequestMessageBody;
   type: typeof PROTOCOL_MESSAGE_TYPE.PROPOSAL_REQUEST_MESSAGE_TYPE;
 };
 
+/** @beta  ProposalRequestCredential is struct the represents proposal request credential */
+export type ProposalRequestCredential = CredentialSchemaInfo;
+
 /** @beta ProposalRequestMessageBody is struct the represents body for proposal-request */
 export type ProposalRequestMessageBody = {
   credentials: ProposalRequestCredential[];
-  metadata?: { type: string; data?: JsonDocumentObject };
   did_doc?: DIDDocument;
 };
 
@@ -25,12 +28,6 @@ export type ProposalMessageBody = {
   proposals: Proposal[];
 };
 
-/** @beta  ProposalRequestCredential is struct the represents proposal request credential */
-export type ProposalRequestCredential = {
-  type: string;
-  context: string;
-};
-
 /** @beta Proposal is struct the represents proposal inside proposal protocol message */
 export type Proposal = {
   credentials: ProposalRequestCredential[];