feat: get credential registry state (tever vcstate)

examples/integration-scripts/credentials.test.ts

@@ -1,5 +1,5 @@
 import { strict as assert } from 'assert';
-import { Saider, Serder, SignifyClient } from 'signify-ts';
+import { Ilks, Saider, Serder, SignifyClient } from 'signify-ts';
 import { resolveEnvironment } from './utils/resolve-env';
 import {
     assertNotifications,
@@ -248,6 +248,15 @@ test('single signature credentials', async () => {
         await waitOperation(issuerClient, op);
     });
 
+    await step('holder can get the credential status before or without holding', async () => {
+        const state = await retry(async () =>
+            holderClient.credentials().state(registry.regk, qviCredentialId)
+        );
+        assert.equal(state.i, qviCredentialId);
+        assert.equal(state.ri, registry.regk);
+        assert.equal(state.et, Ilks.iss);
+    });
+
     await step('holder IPEX admit', async () => {
         const holderNotifications = await waitForNotifications(
             holderClient,

src/keri/app/credentialing.ts

@@ -229,6 +229,23 @@ export interface IpexAdmitArgs {
     datetime?: string;
 }
 
+export type CredentialState = {
+    vn: [number, number],
+    i: string,
+    s: string,
+    d: string,
+    ri: string,
+    a: { s: number, d: string },
+    dt: string,
+    et: string
+} & ({
+    et: "iss" | "rev",
+    ra: Record<string, never>
+} | {
+    et: "bis" | "brv",
+    ra: { i: string, s: string, d: string }
+});
+
 /**
  * Credentials
  */
@@ -285,6 +302,20 @@ export class Credentials {
         return includeCESR ? await res.text() : await res.json();
     }
 
+    /**
+     * Get the state of a credential
+     * @async
+     * @param {string} ri - management registry identifier
+     * @param {string} said - SAID of the credential
+     * @returns {Promise<CredentialState>} A promise to the credential registry state
+     */
+    async state(ri: string, said: string): Promise<CredentialState> {
+        const path = `/registries/${ri}/${said}`;
+        const method = "GET";
+        const res = await this.client.fetch(path, method, null);
+        return res.json();
+    }
+
     /**
      * Issue a credential
      */

src/keri/core/core.ts

@@ -32,6 +32,8 @@ export const Ilks = {
     vcp: 'vcp',
     iss: 'iss',
     rev: 'rev',
+    bis: 'bis',
+    brv: 'brv'
 };
 
 export const IcpLabels = [

test/app/credentialing.test.ts

@@ -368,6 +368,14 @@ describe('Credentialing', () => {
             lastBody.recipient,
             'EP10ooRj0DJF0HWZePEYMLPl-arMV-MAoTKK-o3DXbgX'
         );
+
+        await credentials.state("EACehJRd0wfteUAJgaTTJjMSaQqWvzeeHqAMMqxuqxU4", "EBVaw6pCqfMIiZGkA6qevzRUGsxTRuZXxl6YG1neeCGF");
+        lastCall = fetchMock.mock.calls[fetchMock.mock.calls.length - 1]!;
+        assert.equal(
+            lastCall[0]!,
+            url + "/registries/EACehJRd0wfteUAJgaTTJjMSaQqWvzeeHqAMMqxuqxU4/EBVaw6pCqfMIiZGkA6qevzRUGsxTRuZXxl6YG1neeCGF"
+        );
+        assert.equal(lastCall[1]!.method, "GET");
     });
 });