@stellar-expert/contract-wasm-interface-parser 1.1.0 → 2.0.0

package/README.md

@@ -10,15 +10,109 @@ npm i @stellar-expert/contract-wasm-interface-parser
 
 ## Usage
 
+Download WASM contract code and call `parseContractMetadata()` function to obtain a parsed contract interface.
+
 ```js
 parseContractMetadata(Buffer.from(/*binary wasm code*/))
-/*{
-    rustVersion: '1.76.0',
-    sdkVersion: '20.0.0',
-    functions: [],
-    enums: [],
-    structs: [],
-    unions: [],
-    errors: []
-}*/
+```
+
+Example output:
+
+```json
+{
+  "unions": [
+    {
+      "name": "Asset",
+      "cases": {
+        "Stellar": [
+          "address"
+        ],
+        "Other": [
+          "symbol"
+        ]
+      }
+    }
+  ],
+  "structs": [
+    {
+      "name": "TickerAsset",
+      "fields": [
+        {
+          "name": "asset",
+          "type": "Asset",
+          "doc": "Short ticker name of the asset"
+        },
+        {
+          "name": "source",
+          "type": "string",
+          "doc": "Data provider ID"
+        }
+      ]
+    }
+  ],
+  "errors": [
+    {
+      "name": "Error",
+      "cases": [
+        {
+          "name": "AlreadyInitialized",
+          "value": 0
+        },
+        {
+          "name": "Unauthorized",
+          "value": 1
+        }
+      ]
+    }
+  ],
+  "enums": [
+    {
+      "name": "SubscriptionStatus",
+      "cases": {
+        "Active": 0,
+        "Suspended": 1,
+        "Cancelled": 2
+      }
+    }
+  ],
+  "functions": [
+    {
+      "name": "config",
+      "inputs": [
+        {
+          "name": "config",
+          "type": "ConfigData"
+          "doc": "New configuration data"
+        }
+      ],
+      "outputs": [],
+      "doc": "Update contract confirguration"
+    },
+    {
+      "name": "set_fee",
+      "inputs": [
+        {
+          "name": "fee",
+          "type": "u64"
+        }
+      ],
+      "outputs": []
+    },
+    {
+      "name": "get_subscription",
+      "inputs": [
+        {
+          "name": "subscription_id",
+          "type": "u64"
+        }
+      ],
+      "outputs": [
+        "Subscription"
+      ]
+    }
+  ],
+  "interfaceVersion": "85899345920",
+  "rustVersion": "1.74.0",
+  "sdkVersion": "20.5.0#9e2c3022b4355b224a7a814e13ba51761eeb14bb"
+}
 ```

package/babel.config.js

@@ -0,0 +1,20 @@
+module.exports = {
+    presets: [
+        [
+            '@babel/preset-env',
+            {
+                corejs: '3.34',
+                useBuiltIns: 'entry',
+                //modules: false,
+                targets: {
+                    browsers: [
+                        '> 1%',
+                        'not dead',
+                        'not op_mini all'
+                    ],
+                    node: '18'
+                }
+            }
+        ]
+    ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stellar-expert/contract-wasm-interface-parser",
-  "version": "1.1.0",
+  "version": "2.0.0",
   "description": "Contract interface metadata parser for binary WASM",
   "main": "index.js",
   "module": "./index.js",
@@ -11,6 +11,14 @@
   "author": "orbitlens <orbit@stellar.expert>",
   "license": "MIT",
   "peerDependencies": {
-    "@stellar/stellar-base": ">=11"
+    "@stellar/stellar-base": ">=12"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.24.8",
+    "@babel/preset-env": "^7.24.8",
+    "babel-loader": "^9.1.3",
+    "jest": "^29.7.0",
+    "webpack": "^5.93.0",
+    "webpack-cli": "^5.1.4"
   }
 }

package/src/xdr-spec-parser.js

@@ -16,100 +16,153 @@ export function parseContractMeta(meta) {
 }
 
 export function parseSpec(entries) {
-    const res = {}
+    return new SpecParser().parse(entries)
+}
+
+
+class SpecParser {
+    constructor() {
+        this.res = {}
+    }
 
-    function addSpec(key, descriptor) {
-        let spec = res[key]
+    /**
+     * @type {{}}
+     */
+    res
+
+    addSpec(key, descriptor, doc) {
+        let spec = this.res[key]
         if (spec === undefined) {
-            spec = res[key] = []
+            spec = this.res[key] = []
         }
-        spec.push(descriptor)
+        spec.push(this.withDocs(descriptor, doc))
     }
 
-    for (const spec of entries) {
-        const value = spec.value()
-        switch (spec._arm) {
-            case 'functionV0':
-                addSpec('functions', {
-                    name: value.name().toString(),
-                    inputs: value.inputs().map(parseParameter),
-                    outputs: value.outputs().map(parseParameterType)
-                })
-                break
-            case 'udtStructV0':
-                addSpec('structs', {
-                    name: parseStructName(value),
-                    fields: value.fields().map(parseParameter)
-                })
-                break
-            case 'udtUnionV0':
-                addSpec('unions', {
-                    name: parseStructName(value),
-                    cases: value.cases().reduce((agg, c) => {
-                        const value = c.value()
-                        agg[value.name().toString()] = value.type ? value.type().map(parseParameterType) : []
-                        return agg
-                    }, {})
-                })
-                break
-            case 'udtEnumV0':
-                addSpec('enums', {
-                    name: parseStructName(value),
-                    cases: value.cases().reduce((agg, c) => {
-                        const value = c.value()
-                        agg[value.name().toString()] = value.value()
-                        return agg
-                    }, {})
-                })
-                break
-            case 'udtErrorEnumV0':
-                addSpec('errors', {
-                    name: parseStructName(value),
-                    cases: value.cases().map(c => ({
-                        name: c.name().toString(),
-                        value: c.value()
-                    }))
-                })
-                break
+    parse(entries) {
+        for (const spec of entries) {
+            const value = spec.value()
+            const {_attributes: attr} = value
+            switch (spec._arm) {
+                case 'functionV0':
+                    this.addSpec('functions', this.parseFunction(attr), attr.doc)
+                    break
+                case 'udtStructV0':
+                    this.addSpec('structs', this.parseStruct(attr), attr.doc)
+                    break
+                case 'udtUnionV0':
+                    this.addSpec('unions', this.parseUnion(attr), attr.doc)
+                    break
+                case 'udtEnumV0':
+                    this.addSpec('enums', this.parseEnum(attr), attr.doc)
+                    break
+                case 'udtErrorEnumV0':
+                    this.addSpec('errors', this.parseError(attr), attr.doc)
+                    break
+                default:
+                    console.log('Unknown spec type: ' + spec._arm)
+                    break
+            }
         }
+        return this.res
     }
-    return res
-}
 
-function parseStructName(value) {
-    let structName = value.name().toString()
-    const lib = value.lib()
-    if (lib.length) {
-        structName += ':' + lib.toString()
+    parseFunction(attr) {
+        return {
+            name: attr.name.toString(),
+            inputs: attr.inputs.map(i => this.parseParameter(i)),
+            outputs: attr.outputs.map(o => this.parseParameterType(o))
+        }
     }
-    return structName
-}
 
-function parseParameterType(type) {
-    const typeName = type.switch().name
-    switch (typeName) {
-        case 'scSpecTypeOption':
-            return `option<${parseParameterType(type.value().valueType())}>`
-        case 'scSpecTypeBytesN':
-            return `bytesn<${type.value().n()}>`
-        case 'scSpecTypeVec':
-            return `vec<${parseParameterType(type.value().elementType())}>`
-        case 'scSpecTypeMap':
-            return `map<${parseParameterType(type.value().keyType())},${parseParameterType(type.value().valueType())}>`
-        case 'scSpecTypeResult':
-            return `result<${parseParameterType(type.value().okType())},${parseParameterType(type.value().errorType())}>`
-        case 'scSpecTypeTuple':
-            return `tuple<${type.value().valueTypes().map(parseParameterType).join()}>`
-        case 'scSpecTypeUdt':
-            return type.value().name()
-        default:
-            return typeName.replace('scSpecType', '').toLowerCase()
+    parseStruct(attr) {
+        return {
+            name: this.parseStructName(attr),
+            fields: attr.fields.map(f => this.parseParameter(f))
+        }
+    }
+
+    parseUnion(attr) {
+        return {
+            name: this.parseStructName(attr),
+            cases: attr.cases.reduce((agg, c) => {
+                const value = c.value()
+                agg[value.name().toString()] = value.type ?
+                    value.type().map(t => this.parseParameterType(t)) :
+                    []
+                return agg
+            }, {})
+        }
+    }
+
+    parseEnum(attr) {
+        return {
+            name: this.parseStructName(attr),
+            cases: attr.cases.reduce((agg, c) => {
+                const value = c.value()
+                if (value.name) {
+                    agg[value.name().toString()] = value.value()
+                } else {
+                    agg[c._attributes.name] = value
+                }
+                return agg
+            }, {})
+        }
+    }
+
+    parseError(attr) {
+        return {
+            name: this.parseStructName(attr),
+            cases: attr.cases.map(c => ({
+                name: c.name().toString(),
+                value: c.value()
+            }))
+        }
     }
-}
 
-function parseParameter(param) {
-    return {
-        name: param.name().toString(),
-        type: parseParameterType(param.type())
+    parseParameterType(type) {
+        const typeName = type.switch().name
+        switch (typeName) {
+            case 'scSpecTypeOption':
+                return `option<${this.parseParameterType(type.value().valueType())}>`
+            case 'scSpecTypeBytesN':
+                return `bytesn<${type.value().n()}>`
+            case 'scSpecTypeVec':
+                return `vec<${this.parseParameterType(type.value().elementType())}>`
+            case 'scSpecTypeMap':
+                return `map<${this.parseParameterType(type.value().keyType())},${this.parseParameterType(type.value().valueType())}>`
+            case 'scSpecTypeResult':
+                return `result<${this.parseParameterType(type.value().okType())},${this.parseParameterType(type.value().errorType())}>`
+            case 'scSpecTypeTuple':
+                return `tuple<${type.value().valueTypes().map(this.parseParameterType).join()}>`
+            case 'scSpecTypeUdt':
+                return type.value().name().toString()
+            default:
+                return typeName.replace('scSpecType', '').toLowerCase()
+        }
     }
-}
+
+    parseStructName(value) {
+        let structName = value.name.toString()
+        if (value.lib.length) {
+            structName += ':' + value.lib.toString()
+        }
+        return structName
+    }
+
+    parseParameter(param) {
+        const {_attributes: attr} = param
+        const res = {
+            name: attr.name.toString(),
+            type: this.parseParameterType(attr.type)
+        }
+        return this.withDocs(res, attr.doc)
+    }
+
+    withDocs(descriptor, doc) {
+        if (doc?.length) {
+            descriptor.doc = doc.toString()
+        }
+        return descriptor
+    }
+}
+

package/test/example-contracts.json

@@ -0,0 +1,318 @@
+{
+  "subscription": {
+    "wasm": "AGFzbQEAAAABpgEbYAN/f38Bf2ACf38Bf2ABfgF+YAJ+fgF+YAN+fn4BfmAAAX5gBH5+fn4BfmACf34AYAN/f38AYAJ/fwF+YAJ+fgF/YAN/f34AYAF/AGABfgBgAn9/AGABfwF+YAV+f39/fwBgBH9/f38BfmAAAX9gAn5/AGAAAGADfn5+AGAEfn5+fgBgA35/fwF/YAZ/f39/f38Bf2AFf39/f38Bf2AFf35+fn4AApEBGAFpAV8AAgFpATAAAgFsATEAAwFsAV8ABAFiAWkAAwF2ATMAAgFiAW0ABAFhATAAAgF4ATcABQF4ATQABQF4ATEAAwFsATYAAgF2AV8ABQF2ATEAAwF2ATYAAwFiATgAAgF2AWcAAwFpATYAAwFiAWoAAwFkAV8ABAFtATkABAFtAWEABgFsATAAAwF4ATUAAgNYVwIHCAkKCAsLDAwNDgMPDw4PBxAOBwEOCQMREgwFDQUNBxMUDRQFFRUWCQMJFQUIAgIDBwICAwQCAgUFDgUFARQXGBkAAAwAAQEAAQABAQEODgEUDBoAAAQFAXABDg4FAwEAEQYZA38BQYCAwAALfwBB6IvAAAt/AEHwi8AACwe9AREGbWVtb3J5AgAGY29uZmlnAEcHc2V0X2ZlZQBIB3RyaWdnZXIASQ91cGRhdGVfY29udHJhY3QASwZjaGFyZ2UATBNjcmVhdGVfc3Vic2NyaXB0aW9uAE0HZGVwb3NpdABOBmNhbmNlbABPEGdldF9zdWJzY3JpcHRpb24AUAVhZG1pbgBRB3ZlcnNpb24AUgNmZWUAVAV0b2tlbgBVAV8AagpfX2RhdGFfZW5kAwELX19oZWFwX2Jhc2UDAgkTAQBBAQsNVmVkIWYgYl1eX2BraQrbbVclAAJAIABC//////////8AVg0AIABCCIZCBoQPCyAAEICAgIAAC10CAX8BfgJAAkAgAadB/wFxIgJBwABGDQACQCACQQZGDQBCASEDQoOQgICAASEBDAILIAFCCIghAUIAIQMMAQtCACEDIAEQgYCAgAAhAQsgACABNwMIIAAgAzcDAAt9AgF/An4jgICAgABBEGsiAySAgICAAAJAAkACQCABIAIQm4CAgAAiBEICEJyAgIAADQBCACEEDAELIAMgBEICEIKAgIAAEJmAgIAAIAMpAwCnDQEgAykDCCEFQgEhBAsgACAFNwMIIAAgBDcDACADQRBqJICAgIAADwsAAAsaACAArUIghkIEhCABrUIghkIEhBCEgICAAAsPACAAIAEQloCAgABCAVELUAECfgJAAkAgASACEJuAgIAAIgNCAhCcgICAAA0AQgAhBAwBC0IBIQQgA0ICEIKAgIAAIgNC/wGDQs0AUQ0AAAALIAAgAzcDCCAAIAQ3AwALFwAgACABEJuAgIAAIAJCAhCDgICAABoLHQAgACABEJuAgIAAIAIQmICAgABCAhCDgICAABoLAgALAgALGQACQCAApw0AQdiDwIAAQSsQo4CAgAAACwsJABDXgICAAAALkgEBAn8jgICAgABBIGsiAiSAgICAACACIAE3AwggAiAANwMAQQAhAwN+AkAgA0EQRw0AQQAhAwJAA0AgA0EQRg0BIAJBEGogA2ogAiADaikDADcDACADQQhqIQMMAAsLIAJBEGoQpYCAgAAhASACQSBqJICAgIAAIAEPCyACQRBqIANqQgI3AwAgA0EIaiEDDAALCwwAIABBAhDDgICAAAtDAgF/AX4jgICAgABBEGsiASSAgICAACABIAAQp4CAgAACQCABKQMAp0UNAAAACyABKQMIIQIgAUEQaiSAgICAACACC40CAgF/BH4jgICAgABB8ABrIgIkgICAgAAgAkEYaiABEK6AgIAAAkACQCACKAIYDQAgAikDICEDIAJBCGogAUEYahCugICAACACKQMIpw0AIAIpAxAhBCABKQNAEJiAgIAAIQUgATUCVCEGIAIgASkDSBCYgICAADcDSCACIAU3AzggAiAENwMwIAIgAzcDKCACIAEpAzg3A2ggAiABKQMwNwNQIAIgBkIghkIEhDcDQCACIAE1AlBCIIZCBIQ3A2AgAiABMQBYQiCGQgSENwNYQZCCwIAAQQkgAkEoakEJELGAgIAAIQNCACEEDAELQgEhBAsgACADNwMIIAAgBDcDACACQfAAaiSAgICAAAtuAgF/An4jgICAgABBIGsiASSAgICAACAAKQMAEJiAgIAAIQIgASAAQQhqEKeAgIAAAkAgASkDAKdFDQAAAAsgASkDCCEDIAEgAjcDECABIAM3AxggAUEQahClgICAACECIAFBIGokgICAgAAgAgubBAICfwJ+I4CAgIAAQfAAayICJICAgIAAQQAhAwJAA0AgA0EQRg0BIAJB0ABqIANqQgI3AwAgA0EIaiEDDAALCwJAAkACQCABQv8Bg0LMAFINACABQbyBwIAAQQIgAkHQAGpBAhCqgICAACACKQNQIgFC/wGDQssAUg0BIAEQhYCAgAAhBCACQQA2AmggAiABNwNgIAIgBEIgiD4CbCACQcAAaiACQeAAahCrgICAACACKQNAIgFCAlENASABQv////8Pg0IAUg0BIAJBMGogAikDSBCsgICAACACKQMwpw0BAkACQAJAIAIpAzhBoIHAgACtQiCGQgSEQoSAgIAgEIaAgIAAQiCIpw4CAAEECyACKAJoIAIoAmwQrYCAgABBAUsNAyACIAJB4ABqEKuAgIAAIAIpAwAiAUICUQ0DIAFC/////w+DQgBSDQNCACEBIAIpAwgiBEL/AYNCzQBRDQEMAwsgAigCaCACKAJsEK2AgIAAQQFLDQIgAkEgaiACQeAAahCrgICAACACKQMgIgFCAlENAiABQv////8Pg0IAUg0CIAJBEGogAikDKBCsgICAACACKQMQpw0CIAIpAxghBEIBIQELAkAgAikDWCIFQv8Bg0LJAFINACAAIAU3AxAgACAENwMIIAAgATcDAAwDCyAAQgI3AwAMAgsgAEICNwMADAELIABCAjcDAAsgAkHwAGokgICAgAALMgACQCACIARGDQAAAAsgACABrUIghkIEhCADrUIghkIEhCACrUIghkIEhBCVgICAABoLbgIBfwJ+AkACQCABKAIIIgIgASgCDEkNAEICIQMMAQsgASkDACACrUIghkIEhBCNgICAACEEAkAgAkEBaiICRQ0AIAEgAjYCCEIAIQMMAQtB8IfAgABBHBCjgICAAAALIAAgBDcDCCAAIAM3AwALJAEBfyAAIAE3AwggACABp0H/AXEiAkEORyACQcoAR3GtNwMACyEAAkAgASAASQ0AIAEgAGsPC0HgiMCAAEEhEKOAgIAAAAuOAQIBfwF+I4CAgIAAQRBrIgIkgICAgAACQAJAIAEpAwBCAFINAEGRgcCAAEEHEK+AgIAAIQMMAQtBmIHAgABBBRCvgICAACEDCyACIAMgASkDCBCwgICAADcDACACIAEpAxA3AwggAEG8gcCAAEECIAJBAhCxgICAADcDCCAAQgA3AwAgAkEQaiSAgICAAAvGAQIBfgR/AkAgAUEJSw0AQgAhAiABIQMgACEEAkADQCADRQ0BQQEhBQJAIAQtAAAiBkHfAEYNAAJAIAZBUGpB/wFxQQpJDQACQCAGQb9/akH/AXFBGkkNACAGQZ9/akH/AXFBGUsNBSAGQUVqIQUMAgsgBkFLaiEFDAELIAZBUmohBQsgAkIGhiAFrUL/AYOEIQIgA0F/aiEDIARBAWohBAwACwsgAkIIhkIOhA8LIACtQiCGQgSEIAGtQiCGQgSEEJKAgIAACzwBAX8jgICAgABBEGsiAiSAgICAACACIAE3AwggAiAANwMAIAJBAhDDgICAACEBIAJBEGokgICAgAAgAQsvAAJAIAEgA0YNAAAACyAArUIghkIEhCACrUIghkIEhCABrUIghkIEhBCUgICAAAsYAEG8gMCAAEEFEJuAgIAAQgIQnICAgAALSgIBfwF+I4CAgIAAQRBrIgEkgICAgAAgAUG8gMCAAEEFEJ2AgIAAIAEpAwAhAiAAIAEpAwg3AwggACACNwMAIAFBEGokgICAgAALRwICfwF+I4CAgIAAQRBrIgAkgICAgAAgAEHBgMCAAEEIEJqAgIAAIAAoAgAhASAAKQMIIQIgAEEQaiSAgICAACACQgAgARsLEgBBwYDAgABBCCAAEJ+AgIAAC0YCAX8BfiOAgICAAEEQayIAJICAgIAAIABByYDAgABBBRCdgICAACAAKQMIIQEgACkDABCigICAACAAQRBqJICAgIAAIAELEgBBzoDAgABBFCAAEJ+AgIAAC7kEAgJ/B34jgICAgABBoAFrIgIkgICAgAACQAJAAkAgARCYgICAACIBQgEQnICAgAANACAAQgI3AwAMAQsgAUIBEIKAgIAAIQFBACEDAkADQCADQcgARg0BIAJBIGogA2pCAjcDACADQQhqIQMMAAsLIAFC/wGDQswAUg0BIAFBkILAgABBCSACQSBqQQkQqoCAgAAgAkH4AGogAikDIBCpgICAACACKQN4IgFCAlENASACQegAakEIaiACQYgBaiIDKQMANwMAIAIgAikDgAE3A2ggAkH4AGogAikDKBCpgICAACACKQN4IgRCAlENASACQZABakEIaiADKQMANwMAIAIgAikDgAE3A5ABIAJBEGogAikDMBCZgICAACACKAIQDQEgAikDOCIFQv8Bg0IEUg0BIAIpAxghBiACIAIpA0AQmYCAgAAgAigCAA0BIAIpA0giB0L/AYNCzQBSDQEgAikDUCIIQv8Bg0IEUg0BIAhCIIinIgNBA08NASACKQNYIghC/wGDQgRSDQEgAikDYCIJQv8Bg0LIAFINASACKQMIIQogACACKQNoNwMIIAAgAikDkAE3AyAgAEEQaiACQegAakEIaikDADcDACAAQShqIAJBkAFqQQhqKQMANwMAIAAgAzoAWCAAIAVCIIinNgJUIAAgCEIgiKc2AlAgACAKNwNIIAAgBjcDQCAAIAk3AzggACAHNwMwIAAgBDcDGCAAIAE3AwALIAJBoAFqJICAgIAADwsAAAsbACAAEJiAgIAAIAEQpoCAgABCARCDgICAABoLXgIBfwJ+I4CAgIAAQRBrIgAkgICAgAAgABCzgICAAAJAIAApAwAiAVANACAAKQMIIQIgARCigICAACACEIeAgIAAGiAAQRBqJICAgIAADwtCg4CAgBAQu4CAgAAAAAsLACAAEJeAgIAAGgsbAAJAELKAgIAADQBCg4CAgDAQu4CAgAAAAAsLCAAQtoCAgAALMgAgABCIgICAACABEL+AgIAAAkAgAkIAUQ0AEL2AgIAAEIiAgIAAIAJCABDAgICAAAsLxQEDAX8CfgF/I4CAgIAAQTBrIgMkgICAgAAQvYCAgAAhBEGBicCAAEEIEMGAgIAAIQUgAyACQgAQwoCAgAA3AxAgAyABNwMIIAMgADcDAEEAIQYDQAJAIAZBGEcNAEEAIQYCQANAIAZBGEYNASADQRhqIAZqIAMgBmopAwA3AwAgBkEIaiEGDAALCyAEIAUgA0EYakEDEMOAgIAAEMSAgIAAIANBMGokgICAgAAPCyADQRhqIAZqQgI3AwAgBkEIaiEGDAALC7YBAwF/AX4BfyOAgICAAEEgayIEJICAgIAAQYmJwIAAQQQQwYCAgAAhBSAEIAIgAxDCgICAADcDCCAEIAE3AwBBACEGA0ACQCAGQRBHDQBBACEGAkADQCAGQRBGDQEgBEEQaiAGaiAEIAZqKQMANwMAIAZBCGohBgwACwsgACAFIARBEGpBAhDDgICAABDEgICAACAEQSBqJICAgIAADwsgBEEQaiAGakICNwMAIAZBCGohBgwACwsMACAAIAEQr4CAgAALRQACQCAAQoCAgICAgIDAAHxC//////////8AVg0AIAAgAIUgAEI/hyABhYRCAFINACAAQgiGQguEDwsgASAAEJGAgIAACxoAIACtQiCGQgSEIAGtQiCGQgSEEJCAgIAAC1ABAX8jgICAgABBEGsiAySAgICAAAJAIAAgASACEJOAgIAAQv8Bg0ICUQ0AQYyIwIAAIANBD2pBuIjAgAAQxoCAgAAACyADQRBqJICAgIAAC64BAwF/AX4BfyOAgICAAEEgayIAJICAgIAAAkACQBCJgICAACIBp0H/AXEiAkHAAEYNAAJAIAJBBkcNACABQgiIIQEMAgtBjIjAgAAgAEEYakHIiMCAABDGgICAAAALIAEQgYCAgAAhAQsgAEEIaiABQgBC6AdCABDsgICAAAJAIAApAxBCAFINACAAKQMIIQEgAEEgaiSAgICAACABDwtB8IDAgABBIRCjgICAAAALCQAQ14CAgAAAC4ECAgJ/An4jgICAgABBMGsiASSAgICAAEEAIQICQANAIAJBGEYNASABQRhqIAJqQgI3AwAgAkEIaiECDAALCwJAAkAgAEL/AYNCzABSDQAgAEHcgsCAAEEDIAFBGGpBAxCqgICAACABKQMYIgBC/wGDQs0AUg0AIAFBCGogASkDIBCZgICAACABKQMIpw0AIAEpAygiA0L/AYNCzQBSDQAgASkDECEEIAAQh4CAgAAaELKAgIAARQ0BQgMQu4CAgAALAAALQbyAwIAAQQUgABCegICAACAEELWAgIAAQcmAwIAAQQUgAxCegICAAEIAELeAgIAAIAFBMGokgICAgABCAgtPAQF/I4CAgIAAQRBrIgEkgICAgAAgASAAEJmAgIAAAkAgASkDAKdFDQAAAAsgASkDCCEAELqAgIAAIAAQtYCAgAAgAUEQaiSAgICAAEICC6gBAgF/AX4jgICAgABBMGsiAiSAgICAACACQRBqIAAQmYCAgAACQCACKQMQpw0AIAIpAxghACACIAEQyoCAgAAgAikDAKcNACACKQMIIQEQuoCAgABCjryN0AdCju6qluu95wEQpICAgAAhAyAAEJiAgIAAIQAgAiABNwMoIAIgADcDICADIAJBIGoQpYCAgAAQioCAgAAaIAJBMGokgICAgABCAg8LAAALPwEBfkIBIQICQCABQv8Bg0LIAFINACABEI+AgIAAQoCAgIBwg0KAgICAgARSrSECCyAAIAE3AwggACACNwMAC1ABAX8jgICAgABBEGsiASSAgICAACABIAAQyoCAgAACQCABKQMAp0UNAAAACyABKQMIIQAQuoCAgAAgABCLgICAABogAUEQaiSAgICAAEICC7YFBAF/A34CfwV+I4CAgIAAQeABayIBJICAgIAAAkACQAJAAkACQAJAIABC/wGDQssAUg0AELqAgIAAEMWAgIAAIQIQtICAgAAhAxCMgICAACEEIAAQhYCAgABCIIinIQVBACEGQgAhBwJAA0AgBq0iCEIghkIEhCEJIAYgBSAGIAVLG60gCH0hCANAIAhQDQIgAUEQaiAAIAkQjYCAgAAQmYCAgAAgBkEBaiIGRQ0EAkAgASkDEKdFDQBBjIjAgAAgAUGAAWpBgIDAgAAQxoCAgAAACyABQSBqIAEpAxgiChC4gICAACABKQMgQgJRDQEgAUGAAWogAUEgakHgABDugICAABogAiABKQPIASILVA0FAkAgAiALfSILQoC4mSlaDQAgCUKAgICAEHwhCSAIQn98IQgMAQsLIAEgC0KAuJkpgEIAIANCABDsgICAACABKQMIUEUNBSABKQMAIQggASACNwPIASABIAEpA8ABIgkgCSAIIAkgCFQbIgh9Igk3A8ABAkAgCSADWg0AIAFBAToA2AEgBCAKEJiAgIAAEI6AgIAAIQQLIAogAUGAAWoQuYCAgAACQCAHIAh8IgggB1QNACAIIQcMAQsLQaCAwIAAQRwQo4CAgAAACyAHUEUNBAwFCwAAC0GggMCAAEEcEKOAgIAAAAtBsIPAgABBIRCjgICAAAALQfCAwIAAQSEQo4CAgAAAC0KOvI3QB0KO0qr27eyiARCkgICAACEIIAIQmICAgAAhCSABIAA3A4gBIAEgCTcDgAEgCCABQYABahClgICAABCKgICAABoCQCAEEIWAgIAAQoCAgIAQVA0AQo68jdAHQo7S6vSsreP1OBCkgICAACAEEIqAgIAAGgsQvYCAgAAQiICAgAAgB0IAEMCAgIAACyABQeABaiSAgICAAEICC/0IBAJ/B34EfwJ+I4CAgIAAQYADayICJICAgIAAQQAhAwJAA0AgA0EwRg0BIAJBmAJqIANqQgI3AwAgA0EIaiEDDAALCwJAIABC/wGDQswAUg0AIABB9ILAgABBBiACQZgCakEGEKqAgIAAIAJBIGogAikDmAIQqYCAgAAgAikDICIEQgJRDQAgAkGoAWpBCGogAkEwaiIDKQMANwMAIAIgAikDKDcDqAEgAkEgaiACKQOgAhCpgICAACACKQMgIgVCAlENACACQbgBakEIaiADKQMANwMAIAIgAikDKDcDuAEgAikDqAIiBkL/AYNCBFINACACKQOwAiIAQv8Bg0LNAFINACACKQO4AiIHQv8Bg0IEUg0AIAIpA8ACIghC/wGDQsgAUg0AIAJBmAFqQQhqIAJBqAFqQQhqKQMANwMAIAJBiAFqQQhqIAJBuAFqQQhqKQMANwMAIAIgAikDqAE3A5gBIAIgAikDuAE3A4gBIAJBEGogARCZgICAACACKAIQDQAgAikDGCEJELyAgIAAIAAQh4CAgAAaAkACQAJAAkAgCRC0gICAACIKVA0AIAZCIIinIgNBBUkNAQJAIAdCIIinIgsNAEKDgICA4AAQu4CAgAAMBQsgCBCPgICAAEIgiKdBgBBLDQIgACAJIAoQvoCAgAAgAkHOgMCAAEEUEJqAgIAAIAIpAwhCACACKAIAG0IBfCIBUA0DEMWAgIAAIQYgAkG4AWpBEGoiDCACQZgBakEIaikDADcDACACQbgBakEgaiINIAIpA4gBNwMAIAJBuAFqQShqIg4gAkGIAWpBCGopAwA3AwAgAiAENwO4ASACIAA3A+gBIAIgBTcD0AEgAiADNgKMAiACIAs2AogCIAJBADoAkAIgAiAJIAp9Igk3A/gBIAIgCDcD8AEgAiAGNwOAAiACIAIpA5gBNwPAASABIAJBuAFqELmAgIAAIAEQt4CAgAAgDCkDACEKIA0pAwAhByAOKQMAIQ8gAikDwAEhECACQdACaiAANwMAIAJB9AJqIAM2AgAgAkHwAmogCzYCACACQcgCaiAPNwMAIAJBmAJqQShqIAc3AwAgAkGYAmpBIGogBTcDACACQbACaiAKNwMAIAJBmAJqQRBqIBA3AwAgAkH4AmpBADoAACACQeACaiAJNwMAIAJB2AJqIAg3AwAgAkHoAmogBjcDACACIAE3A5gCIAIgBDcDoAJCjryN0AdCjtLq3Km9owEQpICAgAAgAkGYAmoQqICAgAAQioCAgAAaIAJBADoAgAEgAiADNgJ8IAIgCzYCeCACIAY3A3AgAiAJNwNoIAIgCDcDYCACIAA3A1ggAiAPNwNQIAIgBzcDSCACIAU3A0AgAiAKNwM4IAIgEDcDMCACIAQ3AyggAiABNwMgIAJBIGoQqICAgAAhACACQYADaiSAgICAACAADwtCg4CAgMAAELuAgIAADAMLQoOAgIDQABC7gICAAAwCC0KDgICA8AAQu4CAgAAMAQtBoIDAgABBHBCjgICAAAALAAALuQMCAX8CfiOAgICAAEHgAWsiAySAgICAAAJAIABC/wGDQs0AUg0AIANBEGogARCZgICAACADKAIQDQAgAykDGCEEIAMgAhCZgICAACADKAIADQAgAykDCCEBELyAgIAAIAAQh4CAgAAaAkAgAUIAUg0AQoOAgIDAABC7gICAAAwBCyADQYABaiAEELiAgIAAAkAgAykDgAFCAlINAEKDgICAIBC7gICAAAwBCyADQSBqIANBgAFqQeAAEO6AgIAAGhC0gICAACEFQgAhAgJAAkACQAJAAkAgAy0AeEF/ag4CAAIBCyAFIAFWDQIgA0EAOgB4IAUhAgsgACABIAIQvoCAgAAgAykDYCIAIAEgAn18IgIgAFQNAiADIAI3A2AgBCADQSBqELmAgIAAQo68jdAHQo7yrpzd1qYBEKSAgIAAIQAgBBCYgICAACEEIAMgARCYgICAADcDiAEgAyAENwOAASAAIANBgAFqEKWAgIAAEIqAgIAAGiADQeABaiSAgICAAEICDwtCg4CAgIABELuAgIAADAILQoOAgIDAABC7gICAAAwBC0GggMCAAEEcEKOAgIAAAAsAAAuAAgIBfwF+I4CAgIAAQdABayIBJICAgIAAIAEgABCZgICAAAJAAkAgASgCAA0AIAEpAwghABC8gICAACABQfAAaiAAELiAgIAAAkAgASkDcEICUg0AQoOAgIAgELuAgIAADAELIAFBEGogAUHwAGpB4AAQ7oCAgAAaIAEpA0AiAhCHgICAABogAS0AaEUNAUKDgICAgAEQu4CAgAALAAALEIiAgIAAIAIgASkDUBC/gICAACABQgA3A1AgAUECOgBoIAAgAUEQahC5gICAAEKOvI3QB0KO0uq4rMXOzSgQpICAgAAgABCYgICAABCKgICAABogAUHQAWokgICAgABCAguRAQEBfyOAgICAAEHQAWsiASSAgICAACABIAAQmYCAgAACQAJAIAEpAwCnDQAgASkDCCEAELyAgIAAIAFB8ABqIAAQuICAgAAgASkD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CwtBASEJIAchDCACIQAgByACRg0CCwJAAkAgBS0AAEUNACAEQaCEwIAAQQQgAygCDBGAgICAAAANAQsgASAHaiELIAAgB2shCkEAIQ0CQCAAIAdGDQAgCiALakF/ai0AAEEKRiENCyAFIA06AAAgDCEHIAQgCyAKIAMoAgwRgICAgAAARQ0BCwtBASEGCyAGC1gBAn8gACgCBCECIAAoAgAhAwJAIAAoAggiAC0AAEUNACADQaCEwIAAQQQgAigCDBGAgICAAABFDQBBAQ8LIAAgAUEKRjoAACADIAEgAigCEBGBgICAAAALEgAgAEGIhMCAACABENyAgIAACw4AIAAgASACENyAgIAAC9oCAQV/I4CAgIAAQRBrIgIkgICAgABBASEDAkAgASgCFCIEQYSGwIAAQQ0gAUEYaigCACIFKAIMIgYRgICAgAAADQACQCABLQAcQQRxDQAgBEGkhMCAAEEDIAYRgICAgAAADQEgBEH3hcCAAEEEIAYRgICAgAAADQEgBEGDhMCAAEECIAYRgICAgAAADQEgACAEIAUQ44CAgAANASAEQa2EwIAAQQIgBhGAgICAAAAhAwwBCyAEQaeEwIAAQQMgBhGAgICAAAANACACIAU2AgQgAiAENgIAQQEhAyACQQE6AA8gAiACQQ9qNgIIIAJB94XAgABBBBDegICAAA0AIAJBg4TAgABBAhDegICAAA0AIAAgAkGIhMCAABDjgICAAA0AQQEhAyACQaqEwIAAQQIQ3oCAgAANACAEQayEwIAAQQEgBhGAgICAAAAhAwsgAkEQaiSAgICAACADCzAAIAEgAC0AAEECdCIAQciGwIAAaigCACAAQbSGwIAAaigCACACKAIMEYCAgIAAAAsiACAAKAIAIgCtQgAgAKx9IABBf0oiABsgACABENiAgIAACxQAIAEgACgCACAAKAIEENuAgIAAC7EGAwF/AX4CfyOAgICAAEHgAGsiAiSAgICAACACIAApAwAiA6ciAEEIdiIENgIgIAIgA0IgiKciBTYCJAJAAkACQAJAIABB/xNLDQAgAEGAAkkNASACQRBqIAQQ54CAgAAgAigCFCEAIAIoAhAhBAJAIAVBCk8NACACIAA2AiwgAiAENgIoIAJBCGogBRDogICAACACQdAAakEMakGCgICAADYCACACQThqQQxqQgI3AgAgAkGCgICAADYCVCACQQM2AjwgAkHohsCAADYCOCACIAIpAwg3AjAgAiACQTBqNgJYIAIgAkEoajYCUCACIAJB0ABqNgJAIAEoAhQgASgCGCACQThqEOGAgIAAIQEMBAsgAkHQAGpBDGpBg4CAgAA2AgAgAkE4akEMakICNwIAIAJBAzYCPCACQYSHwIAANgI4IAJBgoCAgAA2AlQgAiAANgI0IAIgBDYCMCACIAJB0ABqNgJAIAIgAkEkajYCWCACIAJBMGo2AlAgASgCFCABKAIYIAJBOGoQ4YCAgAAhAQwDCyAFQQpJDQEgAkHQAGpBDGpBg4CAgAA2AgAgAkE4akEMakICNwIAIAJBAzYCPCACQbyHwIAANgI4IAJBg4CAgAA2AlQgAiACQdAAajYCQCACIAJBJGo2AlggAiACQSBqNgJQIAEoAhQgASgCGCACQThqEOGAgIAAIQEMAgsgAkEAEOeAgIAAIAJB0ABqQQxqQYOAgIAANgIAIAJBOGpBDGpCAjcCACACQYKAgIAANgJUIAJBAzYCPCACQYSHwIAANgI4IAIgAikDADcCMCACIAJBJGo2AlggAiACQTBqNgJQIAIgAkHQAGo2AkAgASgCFCABKAIYIAJBOGoQ4YCAgAAhAQwBCyACQRhqIAUQ6ICAgAAgAkHQAGpBDGpBgoCAgAA2AgAgAkE4akEMakICNwIAIAJBg4CAgAA2AlQgAkEDNgI8IAJBpIfAgAA2AjggAiACKQMYNwIwIAIgAkEwajYCWCACIAJBIGo2AlAgAiACQdAAajYCQCABKAIUIAEoAhggAkE4ahDhgICAACEBCyACQeAAaiSAgICAACABCykAIAAgAUECdCIBQciKwIAAaigCADYCBCAAIAFB8IrAgABqKAIANgIACykAIAAgAUECdCIBQZiLwIAAaigCADYCBCAAIAFBwIvAgABqKAIANgIACyEAIAEoAhRB1IfAgABBDyABQRhqKAIAKAIMEYCAgIAAAAsCAAsCAAtuAQZ+IAAgA0L/////D4MiBSABQv////8PgyIGfiIHIANCIIgiCCAGfiIGIAUgAUIgiCIJfnwiBUIghnwiCjcDACAAIAggCX4gBSAGVK1CIIYgBUIgiIR8IAogB1StfCAEIAF+IAMgAn58fDcDCAvBAgEIfwJAAkAgAkEQTw0AIAAhAwwBCyAAQQAgAGtBA3EiBGohBQJAIARFDQAgACEDIAEhBgNAIAMgBi0AADoAACAGQQFqIQYgA0EBaiIDIAVJDQALCyAFIAIgBGsiB0F8cSIIaiEDAkACQCABIARqIglBA3FFDQAgCEEBSA0BIAlBA3QiBkEYcSECIAlBfHEiCkEEaiEBQQAgBmtBGHEhBCAKKAIAIQYDQCAFIAYgAnYgASgCACIGIAR0cjYCACABQQRqIQEgBUEEaiIFIANJDQAMAgsLIAhBAUgNACAJIQEDQCAFIAEoAgA2AgAgAUEEaiEBIAVBBGoiBSADSQ0ACwsgB0EDcSECIAkgCGohAQsCQCACRQ0AIAMgAmohBQNAIAMgAS0AADoAACABQQFqIQEgA0EBaiIDIAVJDQALCyAACw4AIAAgASACEO2AgIAACwvyCwEAQYCAwAAL6AsEAAAACAAAAAgAAAAFAAAABgAAAAEAAAABAAAABwAAAGF0dGVtcHQgdG8gYWRkIHdpdGggb3ZlcmZsb3dhZG1pbmJhc2VfZmVldG9rZW5sYXN0X3N1YnNjcmlwdGlvbl9pZAAAAAAAAAAAAAAAAAAAYXR0ZW1wdCB0byBtdWx0aXBseSB3aXRoIG92ZXJmbG93U3RlbGxhck90aGVyAAAAkQAQAAcAAACYABAABQAAAGFzc2V0c291cmNlALAAEAAFAAAAtQAQAAYAAABhc3NldDFhc3NldDJiYWxhbmNlaGVhcnRiZWF0bGFzdF9jaGFyZ2Vvd25lcnN0YXR1c3RocmVzaG9sZHdlYmhvb2sAAMwAEAAGAAAA0gAQAAYAAADYABAABwAAAN8AEAAJAAAA6AAQAAsAAADzABAABQAAAPgAEAAGAAAA/gAQAAkAAAAHARAABwAAAGZlZQA8ABAABQAAAFgBEAADAAAASQAQAAUAAADMABAABgAAANIAEAAGAAAA3wAQAAkAAADzABAABQAAAP4AEAAJAAAABwEQAAcAAAAAAAAAAAAAAAAAAABhdHRlbXB0IHRvIHN1YnRyYWN0IHdpdGggb3ZlcmZsb3cwLjEuMAAAY2FsbGVkIGBPcHRpb246OnVud3JhcCgpYCBvbiBhIGBOb25lYCB2YWx1ZTogAAAACAAAAAwAAAAEAAAACQAAAAoAAAALAAAAICAgICB7ICB7CiwKfSB9MDAwMTAyMDMwNDA1MDYwNzA4MDkxMDExMTIxMzE0MTUxNjE3MTgxOTIwMjEyMjIzMjQyNTI2MjcyODI5MzAzMTMyMzMzNDM1MzYzNzM4Mzk0MDQxNDI0MzQ0NDU0NjQ3NDg0OTUwNTE1MjUzNTQ1NTU2NTc1ODU5NjA2MTYyNjM2NDY1NjY2NzY4Njk3MDcxNzI3Mzc0NzU3Njc3Nzg3OTgwODE4MjgzODQ4NTg2ODc4ODg5OTA5MTkyOTM5NDk1OTY5Nzk4OTlraW5kRW1wdHlaZXJvUGFyc2VJbnRFcnJvckludmFsaWREaWdpdFBvc092ZXJmbG93TmVnT3ZlcmZsb3cABQAAAAwAAAALAAAACwAAAAQAAAD7AhAAEQMQAB0DEAAoAxAAAAMQAEVycm9yKCwgKQAAAFwDEAAGAAAAYgMQAAIAAABkAxAAAQAAACwgIwBcAxAABgAAAIADEAADAAAAZAMQAAEAAABFcnJvcigjAJwDEAAHAAAAYgMQAAIAAABkAxAAAQAAAJwDEAAHAAAAgAMQAAMAAABkAxAAAQAAAENvbnZlcnNpb25FcnJvcgAAAAAAAAAAAAAAAABhdHRlbXB0IHRvIGFkZCB3aXRoIG92ZXJmbG93Y2FsbGVkIGBSZXN1bHQ6OnVud3JhcCgpYCBvbiBhbiBgRXJyYCB2YWx1ZQAMAAAAAAAAAAEAAAANAAAABAAAAAgAAAAIAAAABQAAAAAAAAAAAAAAYXR0ZW1wdCB0byBzdWJ0cmFjdCB3aXRoIG92ZXJmbG93dHJhbnNmZXJidXJuQ29udHJhY3RXYXNtVm1Db250ZXh0U3RvcmFnZU9iamVjdENyeXB0b0V2ZW50c0J1ZGdldFZhbHVlQXV0aEFyaXRoRG9tYWluSW5kZXhCb3VuZHNJbnZhbGlkSW5wdXRNaXNzaW5nVmFsdWVFeGlzdGluZ1ZhbHVlRXhjZWVkZWRMaW1pdEludmFsaWRBY3Rpb25JbnRlcm5hbEVycm9yVW5leHBlY3RlZFR5cGVVbmV4cGVjdGVkU2l6ZQgAAAAGAAAABwAAAAcAAAAGAAAABgAAAAYAAAAGAAAABQAAAAQAAACNBBAAlQQQAJsEEACiBBAAqQQQAK8EEAC1BBAAuwQQAMEEEADGBBAACwAAAAsAAAAMAAAADAAAAA0AAAANAAAADQAAAA0AAAAOAAAADgAAAMoEEADVBBAA4AQQAOwEEAD4BBAABQUQABIFEAAfBRAALAUQADoFEAAAtw8OY29udHJhY3RzcGVjdjAAAAACAAAAAAAAAAAAAAAFQXNzZXQAAAAAAAACAAAAAQAAAAAAAAAHU3RlbGxhcgAAAAABAAAAEwAAAAEAAAAAAAAABU90aGVyAAAAAAAAAQAAABEAAAABAAAAAAAAAAAAAAALVGlja2VyQXNzZXQAAAAAAgAAAAAAAAAFYXNzZXQAAAAAAAfQAAAABUFzc2V0AAAAAAAAAAAAAAZzb3VyY2UAAAAAABAAAAABAAAAAAAAAAAAAAAMU3Vic2NyaXB0aW9uAAAACQAAAAAAAAAGYXNzZXQxAAAAAAfQAAAAC1RpY2tlckFzc2V0AAAAAAAAAAAGYXNzZXQyAAAAAAfQAAAAC1RpY2tlckFzc2V0AAAAAAAAAAAHYmFsYW5jZQAAAAAGAAAAAAAAAAloZWFydGJlYXQAAAAAAAAEAAAAAAAAAAtsYXN0X2NoYXJnZQAAAAAGAAAAAAAAAAVvd25lcgAAAAAAABMAAAAAAAAABnN0YXR1cwAAAAAH0AAAABJTdWJzY3JpcHRpb25TdGF0dXMAAAAAAAAAAAAJdGhyZXNob2xkAAAAAAAABAAAAAAAAAAHd2ViaG9vawAAAAAOAAAABAAAAAAAAAAAAAAABUVycm9yAAAAAAAACQAAAAAAAAASQWxyZWFkeUluaXRpYWxpemVkAAAAAAAAAAAAAAAAAAxVbmF1dGhvcml6ZWQAAAABAAAAAAAAABRTdWJzY3JpcHRpb25Ob3RGb3VuZAAAAAIAAAAAAAAADk5vdEluaXRpYWxpemVkAAAAAAADAAAAAAAAAA1JbnZhbGlkQW1vdW50AAAAAAAABAAAAAAAAAAQSW52YWxpZEhlYXJ0YmVhdAAAAAUAAAAAAAAAEEludmFsaWRUaHJlc2hvbGQAAAAGAAAAAAAAAA5XZWJob29rVG9vTG9uZwAAAAAABwAAAAAAAAAeSW52YWxpZFN1YnNjcmlwdGlvblN0YXR1c0Vycm9yAAAAAAAIAAAAAQAAAAAAAAAAAAAACkNvbmZpZ0RhdGEAAAAAAAMAAAAAAAAABWFkbWluAAAAAAAAEwAAAAAAAAADZmVlAAAAAAYAAAAAAAAABXRva2VuAAAAAAAAEwAAAAEAAAAAAAAAAAAAABJDcmVhdGVTdWJzY3JpcHRpb24AAAAAAAYAAAAAAAAABmFzc2V0MQAAAAAH0AAAAAtUaWNrZXJBc3NldAAAAAAAAAAABmFzc2V0MgAAAAAH0AAAAAtUaWNrZXJBc3NldAAAAAAAAAAACWhlYXJ0YmVhdAAAAAAAAAQAAAAAAAAABW93bmVyAAAAAAAAEwAAAAAAAAAJdGhyZXNob2xkAAAAAAAABAAAAAAAAAAHd2ViaG9vawAAAAAOAAAAAwAAAAAAAAAAAAAAElN1YnNjcmlwdGlvblN0YXR1cwAAAAAAAwAAAAAAAAAGQWN0aXZlAAAAAAAAAAAAAAAAAAlTdXNwZW5kZWQAAAAAAAABAAAAAAAAAAlDYW5jZWxsZWQAAAAAAAACAAAAAAAAAAAAAAAGY29uZmlnAAAAAAABAAAAAAAAAAZjb25maWcAAAAAB9AAAAAKQ29uZmlnRGF0YQAAAAAAAAAAAAAAAAAAAAAAB3NldF9mZWUAAAAAAQAAAAAAAAADZmVlAAAAAAYAAAAAAAAAAAAAAAAAAAAHdHJpZ2dlcgAAAAACAAAAAAAAAAl0aW1lc3RhbXAAAAAAAAAGAAAAAAAAAAx0cmlnZ2VyX2hhc2gAAAPuAAAAIAAAAAAAAAAAAAAAAAAAAA91cGRhdGVfY29udHJhY3QAAAAAAQAAAAAAAAAJd2FzbV9oYXNoAAAAAAAD7gAAACAAAAAAAAAAAAAAAAAAAAAGY2hhcmdlAAAAAAABAAAAAAAAABBzdWJzY3JpcHRpb25faWRzAAAD6gAAAAYAAAAAAAAAAAAAAAAAAAATY3JlYXRlX3N1YnNjcmlwdGlvbgAAAAACAAAAAAAAABBuZXdfc3Vic2NyaXB0aW9uAAAH0AAAABJDcmVhdGVTdWJzY3JpcHRpb24AAAAAAAAAAAAGYW1vdW50AAAAAAAGAAAAAQAAA+0AAAACAAAABgAAB9AAAAAMU3Vic2NyaXB0aW9uAAAAAAAAAAAAAAAHZGVwb3NpdAAAAAADAAAAAAAAAARmcm9tAAAAEwAAAAAAAAAPc3Vic2NyaXB0aW9uX2lkAAAAAAYAAAAAAAAABmFtb3VudAAAAAAABgAAAAAAAAAAAAAAAAAAAAZjYW5jZWwAAAAAAAEAAAAAAAAAD3N1YnNjcmlwdGlvbl9pZAAAAAAGAAAAAAAAAAAAAAAAAAAAEGdldF9zdWJzY3JpcHRpb24AAAABAAAAAAAAAA9zdWJzY3JpcHRpb25faWQAAAAABgAAAAEAAAfQAAAADFN1YnNjcmlwdGlvbgAAAAAAAAAAAAAABWFkbWluAAAAAAAAAAAAAAEAAAPoAAAAEwAAAAAAAAAAAAAAB3ZlcnNpb24AAAAAAAAAAAEAAAAEAAAAAAAAAAAAAAADZmVlAAAAAAAAAAABAAAABgAAAAAAAAAAAAAABXRva2VuAAAAAAAAAAAAAAEAAAATAB4RY29udHJhY3RlbnZtZXRhdjAAAAAAAAAAFAAAAAAAbw5jb250cmFjdG1ldGF2MAAAAAAAAAAFcnN2ZXIAAAAAAAAGMS43NC4wAAAAAAAAAAAACHJzc2RrdmVyAAAALzIwLjUuMCM5ZTJjMzAyMmI0MzU1YjIyNGE3YTgxNGUxM2JhNTE3NjFlZWIxNGJiAA==",
+    "interface": {
+      "unions": [
+        {
+          "name": "Asset",
+          "cases": {
+            "Stellar": [
+              "address"
+            ],
+            "Other": [
+              "symbol"
+            ]
+          }
+        }
+      ],
+      "structs": [
+        {
+          "name": "TickerAsset",
+          "fields": [
+            {
+              "name": "asset",
+              "type": "Asset"
+            },
+            {
+              "name": "source",
+              "type": "string"
+            }
+          ]
+        },
+        {
+          "name": "Subscription",
+          "fields": [
+            {
+              "name": "asset1",
+              "type": "TickerAsset"
+            },
+            {
+              "name": "asset2",
+              "type": "TickerAsset"
+            },
+            {
+              "name": "balance",
+              "type": "u64"
+            },
+            {
+              "name": "heartbeat",
+              "type": "u32"
+            },
+            {
+              "name": "last_charge",
+              "type": "u64"
+            },
+            {
+              "name": "owner",
+              "type": "address"
+            },
+            {
+              "name": "status",
+              "type": "SubscriptionStatus"
+            },
+            {
+              "name": "threshold",
+              "type": "u32"
+            },
+            {
+              "name": "webhook",
+              "type": "bytes"
+            }
+          ]
+        },
+        {
+          "name": "ConfigData",
+          "fields": [
+            {
+              "name": "admin",
+              "type": "address"
+            },
+            {
+              "name": "fee",
+              "type": "u64"
+            },
+            {
+              "name": "token",
+              "type": "address"
+            }
+          ]
+        },
+        {
+          "name": "CreateSubscription",
+          "fields": [
+            {
+              "name": "asset1",
+              "type": "TickerAsset"
+            },
+            {
+              "name": "asset2",
+              "type": "TickerAsset"
+            },
+            {
+              "name": "heartbeat",
+              "type": "u32"
+            },
+            {
+              "name": "owner",
+              "type": "address"
+            },
+            {
+              "name": "threshold",
+              "type": "u32"
+            },
+            {
+              "name": "webhook",
+              "type": "bytes"
+            }
+          ]
+        }
+      ],
+      "errors": [
+        {
+          "name": "Error",
+          "cases": [
+            {
+              "name": "AlreadyInitialized",
+              "value": 0
+            },
+            {
+              "name": "Unauthorized",
+              "value": 1
+            },
+            {
+              "name": "SubscriptionNotFound",
+              "value": 2
+            },
+            {
+              "name": "NotInitialized",
+              "value": 3
+            },
+            {
+              "name": "InvalidAmount",
+              "value": 4
+            },
+            {
+              "name": "InvalidHeartbeat",
+              "value": 5
+            },
+            {
+              "name": "InvalidThreshold",
+              "value": 6
+            },
+            {
+              "name": "WebhookTooLong",
+              "value": 7
+            },
+            {
+              "name": "InvalidSubscriptionStatusError",
+              "value": 8
+            }
+          ]
+        }
+      ],
+      "enums": [
+        {
+          "name": "SubscriptionStatus",
+          "cases": {
+            "Active": 0,
+            "Suspended": 1,
+            "Cancelled": 2
+          }
+        }
+      ],
+      "functions": [
+        {
+          "name": "config",
+          "inputs": [
+            {
+              "name": "config",
+              "type": "ConfigData"
+            }
+          ],
+          "outputs": []
+        },
+        {
+          "name": "set_fee",
+          "inputs": [
+            {
+              "name": "fee",
+              "type": "u64"
+            }
+          ],
+          "outputs": []
+        },
+        {
+          "name": "trigger",
+          "inputs": [
+            {
+              "name": "timestamp",
+              "type": "u64"
+            },
+            {
+              "name": "trigger_hash",
+              "type": "bytesn<32>"
+            }
+          ],
+          "outputs": []
+        },
+        {
+          "name": "update_contract",
+          "inputs": [
+            {
+              "name": "wasm_hash",
+              "type": "bytesn<32>"
+            }
+          ],
+          "outputs": []
+        },
+        {
+          "name": "charge",
+          "inputs": [
+            {
+              "name": "subscription_ids",
+              "type": "vec<u64>"
+            }
+          ],
+          "outputs": []
+        },
+        {
+          "name": "create_subscription",
+          "inputs": [
+            {
+              "name": "new_subscription",
+              "type": "CreateSubscription"
+            },
+            {
+              "name": "amount",
+              "type": "u64"
+            }
+          ],
+          "outputs": [
+            "tuple<u64,Subscription>"
+          ]
+        },
+        {
+          "name": "deposit",
+          "inputs": [
+            {
+              "name": "from",
+              "type": "address"
+            },
+            {
+              "name": "subscription_id",
+              "type": "u64"
+            },
+            {
+              "name": "amount",
+              "type": "u64"
+            }
+          ],
+          "outputs": []
+        },
+        {
+          "name": "cancel",
+          "inputs": [
+            {
+              "name": "subscription_id",
+              "type": "u64"
+            }
+          ],
+          "outputs": []
+        },
+        {
+          "name": "get_subscription",
+          "inputs": [
+            {
+              "name": "subscription_id",
+              "type": "u64"
+            }
+          ],
+          "outputs": [
+            "Subscription"
+          ]
+        },
+        {
+          "name": "admin",
+          "inputs": [],
+          "outputs": [
+            "option<address>"
+          ]
+        },
+        {
+          "name": "version",
+          "inputs": [],
+          "outputs": [
+            "u32"
+          ]
+        },
+        {
+          "name": "fee",
+          "inputs": [],
+          "outputs": [
+            "u64"
+          ]
+        },
+        {
+          "name": "token",
+          "inputs": [],
+          "outputs": [
+            "address"
+          ]
+        }
+      ],
+      "interfaceVersion": "85899345920",
+      "rustVersion": "1.74.0",
+      "sdkVersion": "20.5.0#9e2c3022b4355b224a7a814e13ba51761eeb14bb"
+    }
+  }
+}

package/test/parser.test.js

@@ -0,0 +1,10 @@
+import examples from './example-contracts.json'
+import {parseContractMetadata} from '../index'
+
+describe('Parser', () => {
+    test('parse subscription example meta', () => {
+        const {subscription} = examples
+        const parsed = parseContractMetadata(Buffer.from(subscription.wasm, 'base64'))
+        expect(parsed).toEqual(subscription.interface)
+    })
+})