> For the complete documentation index, see [llms.txt](https://dev-en.omnione.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dev-en.omnione.net/sdk-instruction-guide/core-sdk-guide/ios-wallet/untitled.md).

# IWRecoveryManager

This framework is written with the Objective-C

## Constructor

## Constructor

### initWithName

```
- (instancetype)initWithKeyManager:(IWKeyManager *)keyManager
```

Description

* Initialize the IWRecoveryManager object by letting IWKeyManager be a parameter.

Parameters

| Type           | Parameter  |         Description |
| -------------- | ---------- | ------------------: |
| `IWKeyManager` | keyManager | IWKeyManager object |

Return Value

* Initialized IWRecoveryManager object

## Back Up

### backUpStoredData

```objectivec
- (void)backUpStoredData:(BACKUP_OPTION)range
          encryptionType:(ENCRYPTION_TYPE)type
               backUpKey:(NSString *)key
             extraString:(nullable NSString *)extraString
            successBlock:(void(^)(NSData *backedUpData))successBlock
            failureBlock:(void(^)(NSString *errorMessage,NSUInteger errorCode))failureBlock
```

Description

* Creates recoverable back-up data

  Status of Key Manager must be unlocked state

Parameters

| Type             | Parameter    | Description                                      |
| ---------------- | ------------ | ------------------------------------------------ |
| `BACKUP_OPTION`  | range        | Scope of recovery                                |
| `encryptionType` | type         | encryption type                                  |
| `NSString`       | key          | Encryption key                                   |
| `NSString`       | extraString  | additional data to back-up. Cannot input a `nil` |
| `successBlock`   | successBlock | Back-up completion block                         |
| `failureBlock`   | failureBlock | Back-up failure block                            |

successBlock

| Type       | Parameter    | Description    |
| ---------- | ------------ | -------------- |
| `NSString` | backedUpData | backed-up data |

failureBlock

| Type         | Parameter    | Description        |
| ------------ | ------------ | ------------------ |
| `NSString`   | errorMessage | failure message    |
| `NSUInteger` | errorCode    | failure error code |

For Errorcode and other  relevant message, please refer to BACKUP\_Option and EXCRYPTION\_TYPE.

## Restore

### restoreBackedUpData

```
- (void)restoreBackedUpData:(NSData *)backedUpData
                        key:(NSString *)key
               successBlock:(void(^)(NSString * _Nullable extraString))successBlock
               failureBlock:(void(^)(NSString *errorMessage, NSUInteger errorCode))failureBlock
```

Description

* Restoes data by using the recoverable back-up data.\
  Status of Key Manager must be in unlocked status.

Parameters

| Type           | Parameter    | Description               |
| -------------- | ------------ | ------------------------- |
| `NSData`       | backedUpData | Scope of recovery         |
| `NSString`     | key          | Recovery key              |
| `successBlock` | successBlock | Recovery completion block |
| `failureBlock` | failureBlock | Recovery failure block    |

successBlock

| Type       | Parameter   | Description                                         |
| ---------- | ----------- | --------------------------------------------------- |
| `NSString` | extraString | Additional data message to back up, it may be `nil` |

failureBlock

| Type         | Parameter    | Description        |
| ------------ | ------------ | ------------------ |
| `NSString`   | errorMessage | failure message    |
| `NSUInteger` | errorCode    | failure error code |

For error code and message, please refer to IWErrorDef.h.